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MACHINE LANGUAGE 
Program in the fastest 
language for your Atari 
ST. Learn the 68000 
assembly language, its 
numbering system, use 
of registers, the structure 
& important details of the 


A fantastic collection of useful 
programs and information for 
the ST. Complete programs 
include: super-fast RAM disk; 
time-saving printer spooler; 
color print hardcopy; plotter 
output hardcopy. Explains 
BASIC commands to access 
GEM using VDISYS and 
GEMSYS and describes 
resource files with examples. 
Manipulate text output (size, 
rotation, bold, etc.) Change 
line types (thickness, end- 
points, etc.) Mixing machine 
language with BASIC or C 
programs. Save software 
dollars with these tricks and 
tips. 200 pages $19.95 


GEM Programmers’ Refreno 


A complete guide to 
programming the ST 
using the Graphics 
Environment 
Manager 


CLLLLLL 44h A 





For the serious programmer 
in need of detailed inform- 
ation on the GEM operating 
system. Written especially for 
the Atari ST with an easy-to- 
understand format that even 
beginners will be able to 
follow. All GEM routines and 
examples are written in C 
and 68000 assembly 
language. Covers working 
with the mouse, icons, Virtual 
Device Interface (VDI), 
Application Environment 
Services (AES) and the 
Graphics Device Operating 
System. Required reading for 
the serious programmer 
intrested in understanding 
the ST. 450 pages. $19.95 
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PRESENTING THE ST 


ST INTERNALS 
Essential guide to learn- 
ing the inside information 
on the ST. Detailed de- 
scriptions of the sound & 
graphic chips, internal 
hardware, the I/O ports, 
system addresses, more. 


GRAPHICS & SOUND 
A comprehensive hand- 
book showing you how to 
create fascinating graph- 
ics and suprising music 
and sound from the 
ATARI ST. See and hear 
what sights and sounds 


Take control of your 
ATARI ST by learning 
LOGO-the easy-to-use, 
yet powerful language. 
Topics covered include 
structured programming, 
graphic movement, file 


PEEKS & POKES 
Enhance your programs 
with the examples found 
within this book. Explores 
using the different lang- 
uages BASIC, C, LOGO 
and machine language, 
using various interfaces, 


Gives you an in-depth 
look at this sensational 
new computer. Discusses 
the architecture of the 
ST, working with GEM, 
the mouse, operating 
system, all the various 


instruction set, and use of Fully documented BIOS that you're capable of handling and more. An memory usage, reading interfaces, the 68000 
the internal system assembly listing. Anindis- producing from your excellent book forkidsas and saving from and to chip and its instructions, 
routines. 280pp $19.95 pensable guide. $19.95 ATARI ST. $19.95 well as adults. $19.95 disk, more. $19.95 LOGO. $16.95 
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Software 


P.0, Box 7219 Grand Rapids, Ml 49510 - Telex 709-101 - Phone (616) 241-5510 


Optional diskettes are available for all book titles at $14.95 

Call now for the name of your nearest dealer. Or order directly from ABACUS with your MasterCard, VISA, or 
Amex card. Add $4.00 per order for postage and handling. Foreign add $10.00 per book. Other software and 
books coming soon. Call or write for free catalog. Dealer inquiries welcome—over 1400 dealers nationwide. 
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Sl Seine Waves wie. Meds eee, James Luczak 57ST 


Learn how to use the ST’s sound capabilities and start getting a feel for 
BASIC ST programming. 





BEVIEWS 





Moodula-? (1b! Software. ne}... . oy ae bed ea SR Sol Guber 53ST 


An enhanced Pascal, ideal for large-scale production programming. 


Word Processing 
on ihe Altar BAGG) .. «se A ck eilewes Arthur Leyenberger 75ST 


Six ST word processors are examined and compared. Take your pick. 





COLUMNS 


St REORUS ee hs in hn i Oe a es ee 1 S507 


News on recent releases for the ST. Make your shopping list. 





CBM: Pigte eet sc) Stee a ee ead va a Clayton Walnum 69ST 


Flow of control, arithmetic and function declaration are discussed this month. 
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Graphic Arts 


The Next Step in the Evolution of Software 


Imagine combining the functions of 
Computer Aided Design (CAD), Bus- 
iness Graphics, free-hand drawing, _,— re 
and typesetting programs into Bf 
package. Include functions & Z 
simple spreadsheet for data matw7 ee 
ipulation. Add abilities of a simple _ 
word processor for text annotation” — 

in various fonts, sizes, and rota- 
tions. Mix all these features into a 
single package instead of "inte- 
grating’ separate packages. The - 
result is a new breed of so 

Graphic Arts. The only graphic arts 
program available: The Graphic < 
Artist. 








The Graphic Artist is menu, macro, 4 
command, and language driven. “oe 
You read correctly. Menus for begin- Ou % 
ners, commands and macros for | 
experts. And an optional lanquage 
interpreter for creating custom 
applications. 


Support for dot matrix printers, 
color plotters, and laser printers is 


standard, of course. 


Impressed? Wait until you see a 
demo at a dealer near you! 


The Graphic Artist 


Graphic Arts has finally arrived. 


PROGRESSIVE 

COMPUTER x Language $245 additional 

APPLICATIONS 
2002 McAuliffe Drive The Graphic Artist is a trademark of Progressive Computer 
Rockville, Maryland 920851 Applications, Inc. S20ST is a trademark of Atari Corp. 


(301) 340-8398 epnieighy eu bcaoks Sawieeeae 








TDI SOFTWARE INC. 
10410 Markison Road 
Dallas, TX 75238 
(214) 340-4942 

520ST $79.95 


by Sol Guber 


A good computer needs good lan- 
guages in order to utilize all of its capa- 
bilities. The Atari 520ST is one of the 
newest and best computers on the mar- 
ket today, and TDI, has brought out a 
fine example of what a good language 
should be, Modula-2. 

First, let me explain what Modula-2 
is, for those who haven't heard of it yet. 
Niklaus Wirth, the inventor of Pascal, 
created Modula-2. The language is an 
enhancement and extension of Pascal 
and has five added features: (1) the mod- 
ule concept, in particular, the facility to 
split a module into its definition and im- 
plementation portions; (2) a more sys- 
tematic syntax, which facilitates the 
learning process—every structure start- 
ing with a keyword also ends with one 
(i.e., is properly bracketed); (3) the con- 
cept of process as the key to multi- 
programming facilities; (4) so-called 
low-level facilities, which make it pos- 
sible to breach the rigid type consisten- 
cy rules and allow you to map data with 
Modula-2 structure onto a store with in- 
herent structure; and (5) the procedure 
type, which allows procedures to be dy- 
namically assigned to variables. 

TDI’s Modula-2 compiler implements 
the full language as described by Dr. 
Wirth. It includes separate compilation, 
opaque types, co-routines (pseudo-con- 
current processes) and floating-point 
routines. It is integrated into the GEM 
environment and will support all the 
GEM routines. It also promises to gener- 
ate compact code. 

As in all high-level languages, the 
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Modula-2 package comes in three parts: 
an editor, a compiler and a linker in a 
two-disk package. There’s no copy pro- 
tection on any of the disks, and you can 
arrange the system to fit your needs. 

Also included is a nice demonstration 
of the power of Modula-2. Since most 
programmers don’t spend much time 
with either the compiler or the linker, 
the editor is the most important part of 
the package. This editor is very, very 
nice and quite powerful. 

Modula-2’s is a full-screen editor 
which uses both the mouse and function 
keys. You can point the mouse to the 
spot where you want to work and click 
it. This will be the new spot where writ- 
ing begins. Using the function keys, you 
can move one word right or left, page 
up and down, and move a line up and 
down. 

The arrow keys are also used to move 
around the screen. The deletion func- 
tion works like the movement functions, 
with the ability to delete a character 
right or left, a word right or left, or a line 
right or left. You can undelete with the 
undo function. 

For large insertions or deletions, you 
can mark, then cut or paste text into the 
proper spot. These capabilities are usa- 
ble both with the mouse and drop-down 
menus, as are the function keys. 

There’s one more function unique to 
this editor, one that I’ve never seen on 
another editor. After a program is writ- 
ten, it is compiled. Most of the time, 
there are errors in the compilation. With 
Modula-2’s compiler, the errors are writ- 
ten to a file on the disk. When you re- 
turn to the editing mode, the error file 


and your original file are combined, so 
there are little @s where the errors oc- 
curred. 

All errors in the program are exam- 
ined. There’s even a special function key 
to look for the next @. When the cursor 
is moved to this spot, a message will be 
shown at the bottom of the screen, with 
the error message. The message is fur- 
ther explained in the table of the Mod- 
ula-2 book. There are four pages of pos- 
sible errors, and they’re defined well 
enough that it’s easy to correct them and 
continue. 

This listing of the messages in a file 
that’s merged into your own is one sign 
of the time and effort invested in this 
fine package. The editor, of course, was 
written in Modula-2. 

Figure 1 shows a sample program in 
Modula-2. You can see the various dif- 
ferences between it and Pascal. The first 
is that there are two parts to the program 
—a definition module and an implemen- 
tation module. There’s a difference be- 
tween what a procedure does and what 
the outside world sees of the program. 
You must define what will come out of 
the module. In this case, a cardinal num- 
ber will be “exported” from the module. 

A second difference can be seen in 
the third-to-last line. The language uses 
very strong typing. To return a cardinal 
number from a function that uses a di- 
vision between “longcards,” you must 
specify that the cardinal number is re- 
turned. All procedures and parameters 
must be typed, so the program will 
know what kind of variable it’s handling. 

There are also several subtle points in 
the example module shown in Figure 1. 
One that isn’t seen is what can be done 
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with this module. It can be compiled 
and, when needed by any other pro- 
gram, it can be “imported” into that pro- 
gram. Modula-2, unlike Pascal, can link 
together compiled code via the linker. 
This means that a library can be put to- 
gether, then used just as any other func- 
tion would be. 

A second subtle point is the interface 
between parts of the programs. The defi- 
nition module explains exactly what an- 
other part of the program will “see” of 
the implementation module. The only 
thing visible to the outside environ- 
ment is the procedure “random,” since 
it’s the only thing exported out. Vari- 
ables, variable types and other proce- 
dures can be exported out, too. Objects 
declared in other modules can be refer- 
enced in module M, if they’re explicit- 
ly made to be known in M (ie., if they’re 
“imported” into M). 

The major strength of Modula-2 is 
that many of its parts are hidden from 
the other portions. It’s very easy to write 
and debug parts of programs, since you 
know exactly how they’ll fit together; 
this has to be specified in the definition 
section of the module. 

Also, the fine details of a system need 
not be known at any higher level. The 
same program can be written for two 
different machines, and each will have 
specific I/O that will be imported when 
needed. 

In terms of I/O, you may wish to have 
them available, but don’t need to 
know — or, rather, don’t want to bother 
to learn—how this works in detail. In 
many Cases, you may even wish to hide 
parts away from access, to guarantee 
that they’ll work correctly. 

There are several extensions to Mod- 
ula-2 that were proposed by N. Wirth. 
They include a change in the case syn- 
tax, a new variable type called “string,” 
and two new variables for 32-bit ma- 
chines called “longcard” and “longint.” 
There is optimization for Boolean cons- 
tants. The “set” type is supported by 
several new features, and you’re allowed 
to have open array parameters. 

The most exciting part of the language 
is its having both high-level and low- 
level implementation. For the low-level 
portion, there’s a procedure “code,” 
which allows for the insertion of ma- 
chine language into the object code. 
There's “setreg,” to put values into one 
of the 68000 processor’s registers, as 
well as “register,” to return values. 

On the high-level end, there’s the 
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“type process,” as well as procedure 
‘“newprocess.” “lIotransfer” moves to 
different peripheral devices as needed, 
and procedure “listen” services the in- 
terrupts. The “newprocess” is used to 
have concurrent programming. 

I’ve started using this language and 
have found no bugs at all. There are 
some typos in the documentation, but 
none of these are significant. I’ve typed 
in several of the programs from N. 
Wirth’s book Programming in Modula-2, 
and they’ve worked perfectly. 

The major weakness of the package is 
in the documentation of the GEM rou- 
tines. You’re expected to have read the 
GEM manuals. Without them, many 
GEM routines cannot be used properly. 


Except for this flaw, I have no qualms 
recommending this language to anyone. 
It’s a good way to move away from DRI’s 
C.A 


Sol Guber is a Chemical Engineer with 


a large petroleum servicing company in 
the Midwest. He has a seven-year-old 
daughter who corrects both his articles 
and games — now that her writing skills 
have improved. He’s been programming 
the Atari 800 for four years and now has 
an 520 ST, which his daughter lets him 
use once in a while. 


Figure 1. 


DEFINITION MODULE RandomNumbers 4 


EXPORT Random }3 


PROCEDURE Random(MaxValue : LONGCARD) 


END RandomNumbers. 


IMPLEMENTATION MODULE RandomNumber s¥} 


CONST 
M = 1600808008686 }; 
mi = 10000 ; 
b = 31415821 3 


VAR seed : LONGCARD} 


PROCEDURE Random(MaxValue +s LONGCARD) 


1 CARDINAL 4 


t CARDINAL 3 


PROCEDURE Multiply<p, q # LONGCARD) 1 LONGCARD ; 


VAR p®, q@, qi, pi s LONGCARD ; 


BEGIN 
pi t= p DIV ml 3 
p®@ := p MOD mi 3} 
qi 3= q DIV mi 3; 
q@ := q MOD mi 3 


RETURN (((p@Xqi + pi ¥ q@) MOD mi) X% mil + p@Xq@) MOD My 


END Multiply; 


BEGIN 


seed := (Multiply ¢seed,b) + 1) MOD M 3 
RETURN CARDINAL (¢(¢seed DIV mi) * MaxValue) DIV mi) 3 


END Random }3 


BEGIN ¢% MODULE ¥X) 
seed := 349887 , 
END RandomNumbers. 
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ST NEWS! 


POLARWARE 


Penguin Software adds to their Comprehend Interactive Novel series with The Coveted Mirror, 
Frank and Ernest and Oo-Topos. Pictured below is Transylvania, an earlier series offering. 








Transylvania. 


SUPRADRIVE 

The SupraDrive hard disk for the 520ST and 
1040ST is available in 10-, 20-, 30- and 60- 
megabyte formats, ranging in price from $799 
to $1995. The drives are said to be compatible 
with TOS and all applications software. 

The drive comes ready for connection to the 
ST and improves disk transfer rates 300% to 
1000% over the stock drives. The ST is also 
capable of booting directly from the SupraDrive 
upon initialization. The hard disk comes com- 
plete with a utilities disk containing backup, 
formatting and partitioning programs. 

For additional information, please contact 
Supra Corporation, 1133 Commercial Way, Al- 
bany, NY 97321 — (503) 967-9075. 

CIRCLE #173 ON READER SERVICE CARD 


GRAPHIC COLOR PRINTER 


In Mirror, the evil King Voar has taken con- 
trol of Starbury and its residents, and seeks the 
last piece of the magical, broken mirror which 
would make him invincible. It’s up to you to 
stop him. The second new title is a cartoon 
novel based on the Frank and Ernest comic 
strip, while Oo-Topos is a science fiction novel. 

Another Penguin game, Sword of Kadash, is 
a fantasy adventure with over 200 rooms, each 
having its own puzzles. 

These adventures retail for $39.95 each, from 
Polarware/Penguin Software, 2600 Keslinger 
Road, P.O. Box 311, Geneva, IL 60134 — (312) 
232-1984. 

CIRCLE #172 ON READER SERVICE CARD 








Shanner is marketing the SPC-700CI, a 7-color graphic printer. Some of the printer’s fea- 
tures include: color mixing without smudging, pin- or friction-feed, parallel interface and low 
noise. The printer is capable of printing at 38 or 50 characters/second, on normal paper. 








View Options 


CONTROL P&@A 


















CIRCLE #129 ON READER SERVICE CARD 
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Black, yellow, magenta and cyan are combined 
on a special ribbon. When intermingled, this 
produces up to seven colors. 

The SPC-700CI retails for $299.95. Contact 
Shanner International Corp., 453 Ravendale 
Drive, Mountain View, CA 94043. 






OTHER NEWS 


Batteries Included will shortly be releas- 
ing IxS TALK, a telecommunications pro- 
gram with plenty of power and ease of use. 
A 50,000-word spelling checker and three lev- 
els of macros are also featured. 

Also due is I*S TIME, a time management 
and billing system for professionals. From 
Batteries Included, 30 Mural Street, Rich- 
mond Hill, Ontario, Canada L4B 1B5 — (416) 
881-9941. CIRCLE #175 ON READER SERVICE CARD 


in oe 

Lamar Micro offers a 1-megabyte 520ST 
upgrade for $300, giving the user over 750K 
or RAM. In conjunction with their RAM 
Overdrive, the upgrade lets you set aside the 
upper 512K of RAM as a ramdisk. RAM Over- 
drive retails for $34.95, from Lamar Micro, 
2107 Artesia Boulevard, Redondo Beach, CA 
90278. CIRCLE #176 ON READER SERVICE CARD 


Commnet Systems specializes in telecom- 
munications software and currently offers ST- 
Term. Their newest release is FoReM ST, an 
ST BBS. Some of the many highlights include: 
a feature-packed message and file system, E- 
Mail capability and Sysop commands. For ad- 
ditional information, contact Commnet Sys- 
tems, 7348 Green Oak Terrace, Lanham, MD 
20706 — (301) 552-2517. 

CIRCLE #132 ON READER SERVICE CARD 


Infocom is now a subsidiary of Activision. 
While the consumer probably won't notice 
any changes in the near future, one thing to 
look for may be the release of Cornerstone, 
the powerful IBM productivity package that 
never quite made it in the marketplace. The 
original $495 price may dwindle down to 
$100-$150 if ported to the ST. 





BUSINESS & STATISTICAL SOFTWARE 

Lionheart has advanced software ST pack- 
ages, including: Business Statistics, Sales and 
Market Forecast, Experimental Statistics, 
Multivariate Analysis, Quality Control & In- 
dustrial Experiments, Pert and Critical Path 


Technologies, Forecasting and Time-Series, Decision Analysis Techniques, Linear & Non-linear 
Programming and Optimization. The programs are in machine language, to run at optimum 


speed. Easy to use, with menus at every stage, they’re sophisticated and professional. 


Example data assists learning. The manuals are touted as full books, with illustrations, in- 
dexes and practical examples (the Experimental Statistics book is over 200 pages). 


Lionheart, P.O. Box 379, Alburg, VT 05440 — (514) 933-4918. 


CIRCLE #174 ON READER SERVICE CARD. 
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VIP Professional 


Finally 


— A Business Program that Brings 


Lotus 1-2-3° Functionality to Your Atari ST"! 


VIP Professional is a state-of-the-art, integrated 
spreadsheet program which brings together a spread- 
sheet, a database and graphing capabilities. Professional 
was modeled after the powerful and best-selling Lotus 
1-2-3® program which dominates the business world 


Worksheet Magic 


Nothing is left out of the workings of the worksheet. Ranges of 
cells can be named for convenience; column widths are variable; 
the screen can be split into two windows; titles can be frozen; 
contents of cells may be copied or moved; the worksheet may be 
altered as a whole or only partially; the list goes on and on. 
Perhaps most important, Professional can use and save Lotus 1-2-3 
files for transfer between computers. 


The worksheet includes over 45 special functions to simplify 
commonly used formulas, including powerful financial functions 
for the internal rate of return, present value, and future value. Of 
course Professional also has all mathematical, trigonometric, table, 
conditional and logical functions. 


Database Power 


The built-in database can handle up to 8192 records, with a 
possibility of up to 256 fields. The records can be searched, sorted 
and analyzed to find your best salesperson or your rarest stamp. 
Sorts can be done using multiple criteria, in ascending and 
descending order. And database functions can be used to do up to 
seven different kinds of statistical analyses of your database. 


Graphs 


The graphing capabilities of Professional are astounding. Not 
only are there six completely different types of graphs available, 
there are tens of ways to manipulate the data, titles, grids, colors, 
legends, keys, and scaling of the size of the graph. 


Macros 


Professional also includes sophisticated macro programming 
commands. With several special macro commands, the user can 
actually program Professional to be dedicated to a specific task 
such as accounting. 


Just Minutes to Learn 


Professional is as easy to use as it is powerful. It comes with a 
user-sensitive tutorial for the newcomer. And help is built right 
into the program. With the handy tutorial, you will be able to 
create professional worksheets in just minutes. 


Introducing Professional LITE™ 


For those of you who do not need the full power of 
Professional, we offer Professional LITE™. Though without the 
macros and the database features, and having a smaller sheet size 
(256 columns by 2048 rows, LITE still packs a powerful punch 
for only $99.95! 











Household Budget for 1985 


Insurance 


Mortgage Car Payments Education Food 
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Integrated Spreadsheet Power 


Five Year Stock Portfolio Analysis 
Five Year Summary 


mm Stocks 
ea CD's 


f=) Expenses 


CW ke wees SS oe wa ct = 3 


1981 1982 1983 1984 1985 


Yearly Breakdown 


Easy-to-Use Graphs 


The Power of Professional 
Only $179.95 
Or the Power of LITE 


Only $99.95 


If your dealer is out of stock, order direct. Send your check or 
money order to the address below, together with $3 for shipping 
and handling. In California add 6% sales tax. COD's and purchase 
orders not accepted. Personal checks will be held for three weeks to 
clear. All prices are subject to change without notice. 





4 132 Aero Camino 
SB SI AG Santa Barbara 
SY 8° 27 California 93117 
TECHNCLOGIES 


1p 


(805) 968-9567 


SYSTEM REQUIREMENTS: Amiga with 512K; One disk drive; Monochrome or 
color monitor; Works with printers supported by the Workbench. 


bs Protesontl. Professional Sy emggeaa LITE and LITE are trademarks of VIP Teaco ies 
ration; 1-2-3 and Lotus {-2-3 are pegs trademarks of Lotus Development Corp.; Alan, ST, 
T, and Osos are eaeunarkais of Alan Corporaton. 


eh © 1986 by VIP Technologies Corporation 
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- Sound 
Waves 


by James Luczak 


The one thing that stands out most about demos 
and programs available for the Atari 520ST is the si- 
lence surrounding the machine. I’ve owned an Atari 
since 1979 and have watched sound routines pro- 
gress, from simple one-voice melodies to the truly 
amazing sound productions now possible on the 
Atari 8-bit line of computers. 

It may seem hard to believe, but the 520ST is capa- 
ble of producing sound as good as, if not better than 
the 8-bit computers. However, there’s one problem—a 
lack of information concerning the 520ST’s sound 
capabilities. As you may have noticed, there are two 
commands in ST BASIC that can be used to produce 
sounds. These are “sound” and “wave.” The sound 
command is well documented and more or less self- 
explanatory. The wave command is another sotry. 
There’s almost no useful information in the ST BA- 
SIC Sourcebook on how to use the wave command. 

ST Sound Waves has two purposes: to demonstrate 
how to use the sound capabilities of the 520ST and 
to let you get a feel for programming in ST BASIC. 


About the program. 

Sound Waves is written in a modular fashion. This 
means that everything, from drawing different parts 
of the display to producing a sound, is contained in 
its own module. Each module is accessed via GOSUB 
as it’s needed. I chose this method because it’s very 
easy to follow what each part of the program is doing. 
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VDISYS() and GEMSYS(). 

The VDISYS() and GEMSYS() commands are very 
powerful tools in ST BASIC. The VDISYS() command 
gives you full access to the GEM VDI (Virtual Dis- 
play Interface) library. This, in effect, gives you an 
additional 120+ functions available in the VDI library. 
The GEMSYS() command gives you full access to 
GEM’s AES (Application Environment Services) li- 
brary and an additional 60+ functions. Unfortunate- 
ly, an explanation of how to use the VDISYS() and 
GEMSYS() commands is beyond the scope of this ar- 
ticle. However, once you get the program running, 
you can bypass one of the modules and see what 
shows up missing. Using this method, you can de- 
termine what the various VDISYS() or GEMSYS() 
calls are doing. 


Using Sound Waves. 

Sound Waves is meant to be run in medium reso- 
lution. By applying a modifier to all vertical refer- 
ences (the variable MODY), I tried to make provisions 
to run the program in high resolution, but, since I 
don’t have a monochrome monitor, I haven’t been able 
to test the program. If you’re going to use high reso- 
lution, you may have to make some adjustments to 
get the display to show up correctly. 

Before loading Sound Waves, Listing 1, turn buf- 
fered graphics off. Now you’re ready to use the 
program. 

The display screen is divided into eight sections: 
one for each of the three “voices,’ and sections for 
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noise, period, controls, wave shape, and BASIC code 
display. To activate a voice, simply move the mouse 
pointer to the “tone” or “octave” value desired and 
click the mouse. You’ll hear a short beep, and the val- 
ue that you selected will turn red. 

To change a value, point to the new value and click 
the mouse. The old value will return to normal, and 
the new one will turn red. To turn a voice off, click 
on the OFF box for that voice. For the voice to play, 
you must have both a “tone” and “octave” value select- 
ed. This same procedure is used for all the sections 
of the display. 

To activate or deactivate a section, click on the 
“box” or “value” desired. The “period” section (“enve- 
lope frequency”) is slightly different. The values in 
the “coarse” and “fine” controls determine the fre- 
quency of the envelope. These values are cumulative. 

For example, if you click on coarse 1, then on fine 
7, both values will turn red. The values will add to- 
gether to produce a longer period. To deactivate a 
period value, click on the value that is active (red). 


Megamax C 


for the 


Atari ST 


Featuring 


¢ One pass Compile * In-Line Assembly * Smart Linker 

¢ Full Access to GEM routines * Register Variable 

Support * Position Independent Code « and much more... 
System Includes: 

¢ Full K&R C Compiler (with common extensions) 

¢ Linker * Librarian » Disassembler * C Specific Editor 

¢ Code Improver * Documentation * Graphical Shell 


Compile Execute : 
Benchmark Time Time Size 
Sieve 70 2.78 5095 


"Hello, world" 63 N/A 4691 
*Times in seconds. Sieve with register variables. 


$ 1 9 9, 9 5 For more information, _ OF write: 


Megamax, Inc 


Box 851521 
Richardson, TX 75085 


(214) 987-4931 
VISA, MC, COD ACCEPTED 


CIRCLE #125 ON READER SERVICE CARD 
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The value will return to normal. You can have all (or 
any combination) of the values in the coarse and fine 
controls active at once. _ 

As you select different values, the BASIC code re- 
quired to produce the tone is displayed in the BA- 
SIC section of the display. This section is 
automatically updated each time you make a change. 
If you create a sound you want to reproduce in your 
own program, simply jot down the code that appears 
in the BASIC code section. 


Using the mouse. 

Since this program is written entirely in BASIC, 
the mouse click is probably slightly slower than you’re 
used to. Hold the mouse button (left) a little longer 
than usual. After you click the mouse and hear the 
beep, move the mouse pointer away from the area 
that you clicked on. 


The wave command. 
Table 1 breaks down the “wave” command and its 
parameters. The first parameter (“enable”) can have 


WHAT IS 


ST-CHECK? 


Most program listings in ST-Log are 
followed by a table of numbers appear- 
ing as DATA statements, called “ST 
CHECKSUM DATA.” These numbers 
are to be used in conjunction with ST- 
Check (which appeared in ANALOG 
Computing/ST-Log issue 41. 


ST-Log (written by Clayton Walnum) 
is designed to find and correct typing 
errors when readers are entering pro- 
grams from the magazine. For those 
readers who would like copies of these 
articles, you may send for back issue 
41 ($4.00). 


ANALOG Computing/ST-Log 
PO. Box 625, Holmes, PA 19045 


ST-LOG 


a value from 1 to 63, depending on what combina- 
tion of voices and noise you select. The values in the 
chart are typical. The enable parameter is a 6-bit word 
that enables the “tone” and “noise” channels. Table 
2 shows a breakdown of the “enable word.” The enve- 
lope, shape, period and delay parameters shown in 
Listing 1 are the actual values to use. 


First impressions of ST BASIC. 

One of the reasons I wrote this program was to get 
a feel for programming in ST BASIC. The language 
itself has a nice variety of powerful and versatile com- 
mands from which to choose. 

The label option (the ability to name a line) is quite 
useful for making program listings easier to read. As 
I previously described, the VDISYS() and GEMSYS() 
commands give you full access to the VDI and AES 
libraries. These two commands more than double the 
number of functions available from ST BASIC—if you 
know how to use them. And, as far as pure number 
crunching is concerned, ST BASIC is very fast. 

It does have some serious drawbacks that will keep 
it from being a very useful language. The biggest 
problem is with its windows. Windows have no place 
in a computer language. They make it cumbersome, 
at best, to write a program of any length (for me, it’s 
impossible). They also slow any output to the screen 
to such a degree that the 68000’s speed advantages 
are totally defeated. 

The editor is a disgrace. Once you have the lines 
you want to work on in the edit window, you can 
move the cursor to the area you want to edit. Then, 
as soon as you press a key, the line you’re editing 
turns a very light shade of grey! If this isn’t bad 
enough, the text in the line being edited becomes 
slightly skewed. On top of all of this, the symbols 
in the line being edited change. For instance, the plus 
sign turns into an arrow that points to the left. All 
of this makes it next to impossible to read the line 
you're trying to edit. 

Fortunately, there’s a way around this mess. Ap- 
parently, the team that wrote ST BASIC was aware 
of these problems. ST BASIC programs are written 
to disk as text files. This being the case, you can use 
any text or word processor that produces standard 
text files to write your program. That’s the method 
I used to write this program. Text processors such 
as MicroEMACS, Mince or Letter Express work just 
fine. (ST Writer will not work; the files it produces 
are nonstandard files.) 

When ST BASIC loads a saved program, it checks 
each line for syntax errors. If it finds one, it prints 
the number of the line containing the error and a 


ST-LOG 


Table 1. 






THE WAVE COMMAND 
SYNTAX: WAVE enable,envelope,shape, period delay 


ENABLE — Enables VOICE or NOISE, or VOICE with NOISE 



























CHANNEL TONE VALUE NOISE VALUE ie ne 

e 2 16 18 

3 4 32 36 

2+3 6 48 54 

14243 7 56 63 
ENVELOPE — Enables ENVELOPE for VOICES 

VOICE VALUE 







1 1 





































2 
4 
142 3 
143 5 
2+3 6 
14243 7 
SHAPE — SHAPE/CYCLE control 
VALUE DESCRIPTION 
ees peer alternate,hold 
WAR Snes S ebewune ae attack,alternate,hold 
fd atacdecke wareses continue 
De 0g 8 dE ve wes continue,hold 
4D 365s 624H 59 continue,alternate 
| a ae continue,alternate, hold 
[ne continue,attack 
Tel dhurakwarce aes continue,attack,hold 
14 se maconca wees continue,attack,alternate) 
Ts Gove eo bus continue,attack,alternate,hold 
PERIOD — Controls frequency of the ENVELOPE 
VALUE DESCRIPTION 
10): FINE tune value 
256-32768........ COARSE tune value 












DELAY — Sets time in 1/50-second increments before 
BASIC resumes execution 

Use any desired value. If your WAVE command doesn't seem to 

be working the way you think it should, try increasing this value. 
HOW TO USE THE WAVE COMMAND. 

First, use the SOUND command to select the voice or voices 
desired, and set the NOTE and OCTAVE values. Set the VOL- 
UME and DURATION to 0. When using the WAVE command, 
the VOLUME and DURATION values in the SOUND command 
are disabled. Next, set the values for the WAVE command. As 
your program runs, the SOUND command will take on the 

parameters set in the WAVE command. 


Table 2. 


THE ENABLE PARAMETER 
FUNCTION DECIMAL VALUE 
Tone Channel 1 
Tone Channel 2 




















Tone Channel 3 
Noise Channel 1 
Noise Channel 2 
Noise Channel 3 
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description of the error, then continues to load the 
rest of the program. 

This undocumented feature makes it even easier to 
use an external text processor to write programs. All 
you have to do is write down the line numbers and 
use ST BASIC’s editor to correct the errors. This 
reduces your exposure to ST BASIC’s editor. 

Like any programming language, ST BASIC has its 
share of bugs. Most of those I encountered were mi- 
nor and could be worked around. However, there's one 
that’s very serious. 

After your program grows larger than about 10K, 
this program killer shows up. When you try to save 
your program (SAVE AS / REPLACE), ST BASIC will 
erase any previous copy with the same name of your 
program on disk, then lock up. 

There’s no way out. You have to press the RESET 
key. If you haven't taken the precaution of saving your 
program under a different name, or on another disk, 
you'll lose your entire program. 

There’s a way to avoid this nasty little bug: before 
saving your program, type CLEARW 2 (Clear window 
2), then SAVE your program. This seems to eliminate 
the bug, but I like to stay on the safe side when writ- 
ing large programs, and always keep a copy of the pro- 
gram on another disk—just in case. AI 


Jim Luczak maintains and operates electronic tele- 
phone switching and processing equipment. He’s been 
writing computer programs since 1979, having bought 
his first Atari in 1980, and has written in BASIC, C, 
LOGO, FORTH, Action!, and 6502 assembly. He en- 
joys writing dedicated database programs. 


Listing 1. 
ST BASIC listing. 


168 ‘'5265T SOUND WAVES Revision 1.6 

116 ‘*##3hee% by JIM LUCZAK ete 

iZ@ sy-peek(systab} 

1368 if sy-i then i586 

146 if sy-2 then 1786 

156 filcol=-1: filcoli-1:mody-2 

166 goto 248 

176 filcol=2: filcoli-3:mody-1 

186 poke contrl,26: poke contrit2,8:pok 

e@ contrilt6,2: poke intin,3 

i386 poke intint2,i:ivdisys (i) 

266 ra-peek Cintoutt2) :gi-peek Cintouttd 

1 > bi-peek Cintoutto) 

216 poke contr1,14:poke contrl1t2,8:pok 

e contrl1t6,4: poke intin,? 

226 poke intint?2,@: poke intint4,@: poke 
intint6,1866 :vdisys i) 

236 © --- PROGRAM INITIALIZATION --- 

246 coorx-685:coory-—46*mody:coorxi-Iic 

ooryi-22%mody :cellh-38 

258 ah-gb i gintout—peek Cahti12) :gintin-p 

eek Calt3) 

266 dim VV1(13) ,Vvpl1(8) ,hpl (2) ,mh1 (26), 

mV1(58) ,V1ld(26) , vc C3) ,vn(3) ,voty) 
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270 dim nvl(3),pc (8) ,pcité) ,pfts) ,pfit 
6) ,pvo0it6), pvo2 (8) ,puni (6), pun? (12) 
286 dim cvl(4), nc (3), enic24), evitd),ev 
2(3) ,evs (3) 

298 for x=i to 26:read mMhI(x):next x:M 
VICLI-LIZI mv (23-123 

300 for x-1 to 26:read vVIidCx} :next x 
316 read nhl:for x-1 to 8:read nvl tx}: 
next x 

320 for x-8 to 23:read enitx} inext x 
oe for x-i to 8:read pc tx) ,pft(x} inext 


340 for X=1 to 4:read cvlCx} inext x 
350 ' -------- DRAW SCREEN ~--------- 
seo fullw 2:clearw 2 

370 gosub DOHEADER:wm-2:gosub WRITEHEA 
38Q x1=50:x2=80:x3=2:x4=1:gosub DOVBAR 


5 

390 wm-4:gosub SETWRITEMODE:gosub DOOF 
F:wm-2:g0sub SETWRITEMODE 

406 x2-6:go0sub DOVBARTEXKT 

410 x3-6:x4-i:mv-I:gosub DOVBARNLUM 
4268 gosub BONOISE 

426 gosub DOPERIOD 

446 gosub DOCONTROLS 

4568 gosub BDOSHAPE 

466 color i1,1,i:gotoxy 47,123%mody:?7"'BA 
SIC CODE"; 

476 Aa DOLINES 

480 =i:gosub SETWRITEMODE 

496 ie Scour tise MAIN PROGRAM LOOP ------ 
500 poke gintin,257:gemsys (78) 

585 poke systabt+74,1 

510 while mkey <> 2: gemsys5(79) 

520 mx-—peek (gintoutt2) :my—peek (gintout 
#4) :mkey—peek (gintoutt6) 

530 if mkey-1i1 then gosub CHECKKEY 

546 wend 

545 poke systabt24,86 

558 poke gintin, 2756: gemsys (78) :clearw 


Z 

566 poke contrl,i4:poke contrlt2,8:pok 
@ contrl1t6,4:poke intin,3 

570 poke intint?,ri:poke intint4,gi:po 
ke intint6,biivdisys ti) 

588 clear:end 

608 CHECKKEY: 

6168 gosub CHECKMOUSEHLOC 

676 if hci-id then return 

630 if hci-18 and hc2-1 then 6586 

648 sound 1,89,5,7,8:wave 1,1,1,256,86 
656 gosub DOPARAMETERS 

668 gosub DOCHANGE 

678 gosub DOBASICCODE 

688 return 

786 DBDOHEADER: 

718 poke contrl,?73:poke contrit2,8@:pok 
@ contrlt6,i:poke intin,2:vdisysti} 
726 poke contrl,24:poke contrilt2,8:pok 
e contrl1t6,1: poke intin,5: pudisys (1) 
738 poke contrl, 25:poke contri 8:pok 
woe os ©. poke intin, filcoli: vdisys 


7486 poke contrl,1i:poke contrit2?,2:pok 
e contr1t6,8:poke contr1t+i8,9 

7586 poke ptsin,coorx: poke Ptsintz, coor 
2¢ :poke pPtsintd coorxi 

60 poke ptsint6, cooryi:vdisys (i) :retu 


780 WRITEHEADER: 

798 gosub SETWRITEMODE 

$86 poke contrl,i2Z:poke contrit2Z,i1:pok 
e contrl1+t6,6 

818 poke ptsin,@: poke ptsintZ2,16:vdisy 


§(1i} 
820 poke contrl!,i196:poke contrit2,6:po 
ke contrit6,i:poke intin, 5: vdisys (i) 
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638 color 1i1,i,1 

648 read tnum,x,y:poke contrl,&8: poke c 

ontrilt+2,i:poke contrit6, tnum 

658 for tx-@ to tnum-i:iread ascii:poke 
INtint(tx¥2Z) ,ascirinext tx 

ae Poke ptsin,x:poke ptsint2,yivdisys 


C 

$878 poke contrl,i2Z:poke contri1+2Z,1:pok 
e contr1t6,6 

rr Poke ptsin,@:poke ptsint2,6:vdisys 


898 poke contr!,186:poke contrit2,8:po 
ke contrilt6,i:poke intin, 8:vdisys (1) 
986 return 

978 DOVBARS: 

970 poke contrl1,23:poke contrit+2,8:pok 
® contrl+6,i:poke intin,@:vdisys (1) 
949 bary—-122%mody : baryi-5S8*mody 

956 for x=xi to (x2*x3)+xi step x2 

9686 poke contrl,ili:poke contr1lt?,2:pok 
@ contrl1t6,8:poke contr1ti8,i 

978 poke Ptsin,x:poke Ptsint?2?,bary:pok 
e Ptsint4,x-15:poke Ptsint6,baryl 

980 vdisys (1) 

998 poke ptsin,xtiS:poke ptsint2,bary: 
poke ptsint4,x:poke ptsint6,baryli 

16868 Vdisystij iif x4-1 then gosub OFFB 


16816 next xireturn 
OFFBOX: 


1838 poke ptsin,xtiS:poke ptsint2,bary 
+(i8*#mody) 
1846 poke ptsintad,x-iS:poke ptsint6,ba 


ry 

1050 vdisys (1) 

1960 return 

1088 DOVBARTEXT: 

1098 gotoxy %,2¥%mody:?"VOICE 1": gotoxy 
12,2%mody:?"Y0ICE 2" 

1198 gotoxy 271,2¥%mody:?"VOICE 3" 

1119 DOVTEHXT: 

1128 poke contrl1,@®: poke contril+?2?,i1:pok 
e contrl+6,1i 

1138 color filcol,1i1,i:for tx-1 to x? 

1148 read tnumiread x:for xi-1i to tnunm 
:r@ad ascii 

1158 poke intin,ascii:poke pPtsin,xX:pok 

e ptsint?, baryit (cel Lh¥x1) 

1166 vdisysti}:next xi,tx:color 1i,4,1: 

return 

1186 DOVBARNUM:color filcoli,i,1i 

1198 poke contrl1,i2:poke contri+#?,1:po 

ke contrilt6,27:poke pPptsin,8 

1206 poke ptsint?,4:vdisys(i) :cellh=pe 

ek (ptsoutt6) 

1218 poke contr1,@:poke contri+2,1 

12280 for x?-1 to x3:tnum-i:read xi .Xi9 

osUb SAVEHLOC 

1230 for tx=@ to xi-i:read ascii:if tx 

?=9 then tnum-?2 

i248 poke contrit6,tnum:poke intin,asc 


il 

12568 if tnhum-2 then read ascii:poke in 
Tint2, ascii 

i268 poke ptsin,x: poke ptsint?2,bary-(c 
@llh*®tx)} 

he vVdisystidiaf x2-2 then gosub SAVE 
1286 next tx,x2 

1298 poke contrl1,i2:poke contrl+2,i:po 
ke contrits,6 

i386 poke ptsin,@:poke ptsint2,6:vdisy 


1318 cellh-8:color 1,1,i:return 

1338 DONOISE : modi-18:x4=-2 

1346 gotoxy 38,2*%mody:?7"APPLY NOISE": c 
Olor filcol,i,i 

1358 gotoxy 38,3%mody:7"VOICE":color i 


i,1i 
1366 read x:for xi-1i to 8:poke contri, 


1378 poke contrilt2,i:read tnum:poke co 
ntrit6, tnum 

i386 for tx—-8 to tnum-L:read a5C11:pok 
@ iantint(tx#®2}) ,asciiinext tx 

1398 poke ptsin,x:poke ptsint2,baryitt 
cellh*®xi}tmodi:vdisys (13 

1466 poke contrl1,ii:poke contrilt2,2:po 
ke contrl1t6,@:poke contrit+ié,i 

1416 poke ptsin, xt88: poke ptsint2,bary 
itft{cellh*®xi}tmodi 

1426 gosub SAVEYVLOC 

1438 poke ptsint4,xt5S@:poke ptsint6, tb 
aryit(cellh®xi})+(modi-7) :vdisys (is 
1449 next xi:x=nhl :npl=8:asc1i-8: thum— 


i 
1458 yonvlinpl}):gosub MAKECHANGE :retur 


n 

14760 DOLINES: 

1486 poke contrl1,i6:poke contrit2,i:po 
ke contrit6,8:poke ptsin,6 

1498 poke ptsint2,@:vdisys ti} 

i506 linef coorxi,112,coorx,112:linef 
458,29,6605,29 

i518 poke ptsin, 3: vdisys (1) 

1528 linef 96,cooryi-3,98,112:linef 17 
8,cooryi-3,178,112 

i530 linef 255,cooryi-23,255,112:linef 
365 ,cooryi-2,365,112 

1548 linef 458,cooryi-2,458,112:linef 
332,112,332,198 

i550 linef 332,126,6865,126 

i566 poke ptsin,i:vdisys(i1) ireturn 
i586 DOPERIOD: 

1598 gotoxy 43,2*mody:?"PERIOD" 

1600 x1-412:x2=1:x3-8:x4-8:gosub DOVBA 


16180 x2-—2:go0sub DOVTEXT 

162780 x3-2:x4-I:gosub DOVBARNUM 

1628 return 

1656 DOCONTROLS: 

1660 gotoxy 55,2%mody:?"CONTROLS" 

16780 poke contrl1,23:poke contri1t2,6:po 
ke contrlt+6,i:poke intin, 2:vdisys (1) 
1680 poke contrl,24:poke contrit2,6:po 
ke contrlt6,1i:poke intin,4:¥disys (i) 
1698 poke contrl1,25:poke contrit2,@:po 
ke contrlt+6,1i:poke intin, filcoll 

1780 vdisys (i) 

1718 poke contr],114:poke contrit+Z,2:p 
oke contrl1t+6,0:poke ptsin,605 

1726 poke ptsint?,i32*mody:poke ptsint 
4,453 :poke ptsint6,52%modyivdisys Ci} 
1738 poke contrl,Z23:poke contrit2,6:po 
ke contrl1+6,i:poke intin,i:vdisys (1) 
1748 poke contrl,ii:poke contrlt2,2:po 
ke contrl+6,8:poke contrl1tis8,3 

i. X1-—68%mody :x27-8:x3-18*mody: x4-4:x 
ty eal yi-xi to xit(xiI#2) step x3:x2 
=x 

1778 poke ptsin,595:poke ptsint2,yi:po 
ke ptsint4,460:poke ptsint6,yi-16 

1780 vdisys(ti)d:gosub SAVEVLOC: next y1l 
1790 aS(i}3="SOUND ON":a5(2)="SO0UND OFF 
Me aS (ZV —"RESET VOICE": a$(4)—"QUIT" 
i880 color @,1,1:x1i-S5:for x-6@ to 3:if 
x-3 then xi-57 

1810 if x-2? then xi-54 

1828 gotoxy x1, (4¥mody) + (x¥2) :7a5 (xt1) 
“next x:color 1,1i,i:return 

1846 DOSHAPE: 

1850 x4-S:gotoxy 4,12%#mody: 7"ENVELOPE 
SHAPE/CYCLE" 

18660 poke contrl,ii:poke contrlt2,2:po 
ke contr1t+6,@0:poke contri1+t+i@,1i 
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1870 read x:for tx-=i to x:read xi,yi:x 
2-X%1-1686 : y2-y1-16%mody : yi-yi*mody 

1880 poke ptsin,xi:poke dare ald ala ai 
e ptsint4d,xZ: poke PeSAnts .y2 

eae Vdisys(iJ iif tx-6 then gosub SAVE 
1966 next tx 

1916 poke contrl,6:poke contr1+t6,8 
1926 color 1,1,8:read tnum: for txi-i t 
o tnun 

1338 gosub MAKESHAPE 

139486 next txi:return 

19686 DOBASICCODE: 

1978 gotoxy 486, 14*mody: 7™ SOUND 1,8,"'vn 
Cid", "voti3",6 

1986 gotoxy 40, is*mody: 7™"SOUND 2,9,"'Vn 
C23"', "vo t73"'.86 

1996 gotoxy 40, 16*mody: FJ"SOUND 3,8,''Vn 
cans VOLas «a 

2886 gotoxy 40, ai lela Hen "ey 
a8 a Sets =o6g" » 8 

2018 return 

2836 CHECKMOUSEHLOC: 

28046 mce-Othc-i:hci-i:hct-28 

2650 if my>iz? then hc-=Zi:hci-ii:hct-2 


6 

78686 while mc-8 

7070 if mx >= whl thc) and mx <= whi Che 
+1} then mc-i 

7086 if mc-8 then hci-hciti 

7090 hcr~hctZ2:if heo>hct then mc-i 

or wend:if hci?i®8 and hct-28 then hc 
7118 if hci *«-6 then hc2-6 else hc2?=-i 

7138 CHECKMOUSEYVLOC: 

7146 if hci-id then hc2?--1i:return 

7158 mc—O8:mci-S:hc-vldt (hci*®2}-1}3 :hct- 
Vild thc i1*®2)} 

7168 while mc-8 

7176 aif my <=mU]ChC)} and my >= mvil the 
#1} then mc-i:mci-i 

7186 if mc-8 then hc2?-hcZ7ti 

2198 hcer~hct2:if hcthct then mci 

2268 deta ae mci-@ then hci-14:hc2--1 


etu 
2236 DOPARAMETERS : 
2240 if hci ¢ 7? then gosub SETSOUND 
2250 if hci-? then gosub SETNOISE 
2266 if hci-8 or hci-9 then gosub SETP 


2780 if hci-18 then gosub SETCONTROLS 
22860 if hc1>18 then gosub SETSHAPE 
2296 return 
27318 DOCHANGE: 

2315 poke gintin, 27256: gemsys (78) 

2326 if hcit? then gosub CHANGEVOICE 
23380 if hci-? then gosub CHANGENOISE 
2346 if hci-8 or hci-9 then gosub CHAN 
GEPERIOD . 

‘a if hci-i8 then gosub CHANGECONTRO 


5 
2360 if hci>18 then gosub CHANGESHAPE 
2365 poke gintin, 257: gemsys (78) 

23786 return 

2390 SETSOUND: 

2400 on hci goto 2410,2440,2470,2500,2 
530,2560 

2410 if hc2=@ then vc (1)=O:un(12=8:v0C 
13)-B:evilli}-B:igoto 2586 

2420 vc CA=A!VOCLI=HCZreviCAI=L:if vne 
1)=8 then vn{i)=1 

2438 goto 2586 


2446 1f hc2-8 then vc (1-8: uni -eivol 


13=8:evitid-Bigoto 25386 

2458 vcCi-iivnti-heZievilijs-1:if vot 
13=68 then votij-i 

24686 goto 2588 
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24768 if hc2-68 then vc (2)-G:unt23-8: vol 
23-8: evit2)-G:goto 275886 

2488 vc (23 -ZivolZIr~hcZrevil2I—-A:if vnc 
23-8 then vnt2)-i 

2496 goto 27588 

2566 if hc2-8 then vc (2) -O:vn23)-B: vol 
23-8:evilt2)}-G:goto 25886 

2518 vc C23 =Z2:UNn(2I-~hcZ:evil2I—-L1:if vot 
23-68 then vot2)-1 

2528 goto 25886 

2538 if hc2-8 then vc (2)-GB: un (II-B: vol 
33 -B:evillII-GB:goto 2586 

2548 vc CI—A VO CIWI—heZ:evil€IIr-ijA:if vnc 
33-6 then vntII-1i 

2558 goto 25886 

25680 if hc2-8 then vc (7) -B:vnCII-B:vol 
33 -B:evitII-G:goto 2588 

2578 Vc CII—4r UN CPI—hcZrevilI®I—-L:ifF vot 
23-8 then voltI}-1i 

Se ee  ee oe kee See hee ORE EAR ERE ELT 
nc 

2598 gosub ENABLEENV: return 

2616 SETNOISE: 

26286 e-Chc2-1i}*3:for x-8 to 2 

2630 nct(xtil-—enitxte):if nctxt+i}>8 the 
mn @v2(xtij-i else ev2(xti}-86 

7646 next x:en-vc Cid tvuc (2) tuc (33 tnc C1) 
tnc (23 tnc C33 

76586 gosub ENABLEENV: return 

2676 SETPERIOD: 

7686 on thci-7} goto 26986,2728 

2696 if pcithc?3}-8 then pd-pdtpc thc?2): 
Pcithc2}-—i:goto 27198 

77886 if pcithc2}-1 then pd-pd-pc thc?7): 
Pcithc?)-8 

2718 goto 2748 

27280 if PfFIThC23—-8 then pd-pdtpfthc2): 
Pfithc2)}-i:goto 27486 

273860 if pfithc2}3-1 then pd-pd-pfthc?7): 
Pfithc 2}-8 

2746 if pdt@ then pd-8 

2758 return 

2778 SETCONTROLS: 

2786 on hc? goto 279398,2846 , 2868 ,23986 
2798 sound 1,8,¥nCi} ,voti),8 

2866 sound 2,8,¥n(2} ,vot(2},8 

2816 sound 3,8,¥n(3) ,vot3},8 

2820 wave en,ev,sh,pd,8 

2836 goto 793986 

2840 for sx-1i to FJ:sound sx,8,8,8,8:ne 


2858 wave 6,6,8,89,8:goto 2938 

2866 poke gintin, 256: gemsys (78) 

2865 gosub CHANGECONTROLS 

2878 hc2-8: for hci-2Z to 6 step 2:gosub 
CHANGEVOICE : next hci 

2886 hc2-8: gosub CHANGENOISE 

28980 restore 52280: x3-2:x4-I:gosub DOVB 
ARNUM 

23906 shi-i:gosub CHANGESHAPE 

23916 for x=-1 to 3:¥c CxI-G i untxd-G i voltx 
3=H8 evil (x3=-8 

2920 evZ(x}-—G:evI Cx -Ginc (xI-Binext x 
2938 for x-1 to 8: pcitx3-G:pfitxI-Gi py 
oZ(x)-Ginext x 

2346 for x-i to 6:pvolt(x}-B:pyniCx3-6: 
next x 

2956 for x-1 to i2Zipyvn2(x}-Oinext x 
2968 en-@:ev-6:pd-6:sh-8:sSh1-8:sh2-8:5 
h3I-8:npl-6 

23965 poke gintin,257: gemsys (78) 

23976 goto 23986 

23980 mkey-2 

2396 return 

3016 SETSHAPE: 

3628 on (hci-18) goto 38636, 36586, 2866 
S036 shi-hc2:if hc2-1 then sh-i else 1 
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f hc2-—2 then sh-4 else sh-8 

38486 goto 3878 

380580 sh-hcZ2t8:shi-hc2ti:goto 36786 

39680 sh-hc2t1ii1:shi-hc27t6 

30786 return 

38980 EMABLEENY: 

3180 if fCevilidt+ev2(13)>8 then eviti)— 
1 else eviti}—868 

3110 if (Cevit2)4+eV2(23)>0 then ev3I(2)-— 
2 else evi(2)-8 

3120 if CevitI)+eyv2(33I5G then evsy(I)=— 
4 else evitiI}-8 

S138 ev—evsil(idtevIt(2) teviI tI :return 
3156 CHANGEVOICE:px-8 

3168 on hci goto $1786,327258,32348,34276,3 
5168 ,3598 

3178 if pvo2ti}-8 then wm-i:cl-i 

31868 sx-38i:gosub SETOFF:if pyvo2(13}-6 t 
hen goto 3238 

31968 if px-1i1 then px-2:hci-hci-i 

32806 x -hvl (pv01(13) :y-—vvl (pvo021)) : asc 
11—-Pvo02 013448: tnum-L:ici-filcoli:wm-i 
3218 gosub SETMODE:gosub MAKECHANGE 
acon if px-2 then px-@:hcir-hciti:goto 
32380 pvoltid-—hci:pyvo2(ij-—hcZiif hc2z-8 
then px-i:goto 3278 

32468 goto 3678 

3250 if pynZ(id-68 then we-i:ci-i 

3260 sx-J8:gosub SETOFF:if pyn2ti3-6 t 
hen goto 33286 

3278 if px-1i then px=2:hci-hcitt 

3238 X=hvl (pyniti}}) :y-—vvl (pyn2(1)) i asc 
1i1—pvn2Ci} +48: tnunci: cl-filcoli:wm-i 
3290 if punz2(i)>9 then tnum=2:ascii=49 
'aS5Ciiirzéetpunz (1) 

33086 gosub SETMODE:gosub MAKECHANGE 
3318 if px-2 then px-8:hci-hci-i:goto 


3328 punitil=hci:ipyn2(i3-hceZiif hce2=-8 
then px=i:goto 31538 

3336 goto 36786 

33468 if pyvo2(23-8 then wm-i:ci-1 

3358 Sx-118:gosub SETOFF:if pyo2(23-8 
then goto 34686 

33686 if px-1 then px-2Z2:hci-hci-1i 

3378 x -hvl (pvo0i (23) :y-vyl (pyvo02 (23) : asc 
11-PV02 (2) 448: tnum-L:cl-filcoli:wm-i 
3380 gosub SETMODE: gosub MAKECHANGE 
3396 if px=-2 then px-@:hci-hciti:goto 


34808 pyvoilt2)-—hci:pvo2(723)-—hcZ2:if hce2?-8 
then px-i:goto 34486 

3416 goto 3678 

3420 if pyn2(2)-8 then wm-i:clr-i 

34380 Sx-118:gosub SETOFF:if pyvn2(23-86 
then goto 3498 

3446 if px-1i then px-2:hci-hciti 

3450 x=hvl (pynit2)) : y=vvl (pyn2 (233 : asc 
11-—pyn2 (23 4t48: tnum-i:cl-filcoli:wm-i 
2460 if pun? (2939 then tnum-2:as5cii-49 
'3a5C 111-38 tpvyn2 (27) 

4786 gosub SETMODE:gosub MAKECHANGE 
34860 if px-2 then px-8@:hci-hci-i:goto 


3496 pyunit2)—hci:pyn2(2)—hcZ:if hc2-8 
then px-i:goto 323686 

3588 goto 3678 

2318 if Pp¥OoZ(3I}3-8 then wm-i:cl-i 

35280 Sx-198:gosub SETOFF:if pvo2(I3}-8 
then goto 357868 

35380 if px-i then px-2:hci-hci-1i 

32548 x -=hvl (pvo01 (33) :y—vvl (pyvo02 (33) :asc 
11-—pvo02 (33 4+48: tnum-i:cl-filcoli:wm-i 
3558 gosub SETMODE:gosub MAKECHANGE 
ote if px-2 then px-@:hci-hciti:goto 
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h ST Sound Waves continued 


35708 pvoi(3)-—hci:pvo2(II-—hcZi:if hc2-6 
then px-i:goto 3616 

35860 goto 3676 

35908 if pyn2(3)-8 then we-i:cl=-i 

3600 Sx-198:gosub SETOFF:if pyn2(3I3-8 
then goto 36606 

36160 if px-1 then px=2:hci-hciti 

3626 x=hvl (punt (3)) :y=vvl Cpyn2 (3)) : asc 
ii-pyn2(3)+t48: tnum=i: cl-filcoli: what 
3630 if _byn2(33>9 then tnum-2:a5cii-49 
:aSciii-Jéstpyn2 (3) 

3646 ae SETMODE:gosub MAKECHANGE 
etch if px-2 then px=-@:hci-hci-i:goto 
3660 pyniC3 —hci:pynZ2(3 -—hcZi:if hc2-8 
then px-i:goto 3536 

36760 if hc2-6@ then we-4:cl-filcol:igosu 
b SETOFF: goto 37186 

3680 x-hvl Chci)d :y-vvl (hc2) :ascii-hc2t4 
6: tnum-1L:cl=filcol:wa-4 

3690 if hc2>9 then tnum=—2:ascii-49:asc 
111-38thc2 

37808 gosub SETMODE:gosub MAKECHANGE 
3716 Cl=i:wme-i:gosub SETMODE:return 
3738 SETOFF: 

3748 gosub SETWRITEMODE:color cl1,i,i 
3750 poke contrl,&:poke contrl+2,1i:pok 
e contr1+6,3 

3760 poke intin,793:poke intint2, 7@:pok 
e antint4, 78 

3770 poke ptsin,sx:poke ptsint2,baryt(C 
180%mody) -2 

3780 vdisys (i) :return 

3800 MAKECHANGE: 

3810 poke contrl Az seoke contrl+2,i:po 
ke contrl+6,2:poke ptsin,9@ 

3820 poke ptsint2, 4: vdisys(i):poke con 
trl1,é8:poke contrl+2,1i 

3830 poke contrl1t6, tnunm: poke intin, asc 
iitiaf tnum-2 then poke intint2, asciil 
anes poke ptsin,x:poke ptsint2,y:ivdisy 
S 


3850 poke contrl1,i2Z2:poke contrlt2,i:po 
ke contr1+t6,80 

ite poe Ptsin,@:poke ptsint2,6:vdisy 
S 

3880 CHANGENOISE: 

3890 wm-1i:cl-1:x-nhl: tnum-i:ascii-6: go 
Sub SETMODE 

3908 y-nvl (npl):gosub MAKECHANGE 

ue a5cC11-8:y-nvl (hc2) :gosub MAKECHAN 
39280 npl=hc2:return 

39486 CHANGEPERIOD: 

3958 on Chc1-7) goto 3968,39886 

3960 if pcithc2)-8@ then wm-i:cl-filcol 
1 else wm-4:cl-filcol 

3970 goto 3998 

3980 if pfiChC2)-@ then wm-i:cl-filcol 
1 else wn-4:cl-=filcol 

3998 aScii-hc2t48: thum—-1:x-hpl t(hci-7): 
y-vp1 (hc2) 

4000 gosub SETMODE:gosub MAKECHANGE:c]l 
=i:we-i:gosub SETMODE:return 

4020 CHANGECONTROLS: 

4030 wm-2:gosub SETWRITEMODE 

46040 if cpl-68 then 4866 

4050 color @,1,1: gotoxy, cvl(cpl), (4*mo 
dyd*+Ct(cpl- 13*2) 2749 (CPI) 

4060 color filcol,i,1i: sag tony cvlthc2), 
C4¥mody) t€ Chc2- eT as 3 :2a$ (he 

4070 cpl-=hc2:wme-i:cl-i:gosub SETMODE:r 
eturn 

4090 CHANGESHAPE: 

41600 wma-2:gosub SETWRITEMODE 

4116 cl-@:if sh2-68 then 4258 

4126 on sh2 goto 4138,41460,4158,4166,4 
176,4188,4196,42680,4218,42286 

4136 restore SI186:goto 4236 

4148 restore S33G:goto 4236 

4150 restore SI58:goto 42386 

41660 restore 5486:goto 42386 

4170 restore 54260:goto 4236 
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4180 restore 5450:goto 4230 
4190 restore 5478:goto 4230 

4200 restore 5520:goto 4230 

4210 restore 5548:goto 4236 

4220 restore 5570 

4230 color 1,1,Cl:gosub MAKESHAPE 

4240 if sh3=i then sh3=@:goto 4260 
4250 Sh2=Shi:sh3=1:cl=filcol:goto 4120 
4260 color 1,1,41:Cl=i:wm=i:gosub SETMO 
DE:return 

4280 MAKESHAPE: 

4290 poke contrl1,6:poke contr1+6,8 
43600 read x: poke contrl+2,x#2 

4310 for tx-@ to (x*4)-1 step 2:read x 
1,yi:yi-yiknody 

4320 poke Ptsint (tx*®2) ,xi:poke Ptsint( 
(tx¥2342),yi:next tx 

4330 vdisys (1) :return 

4350 SETWRITEMODE: 

4360 poke contr], 32: poke contr1l+2,6:po 
ke contri+6,i:poke intin, wa:vdisys (1) 
4370 return 

4390 DOOFF: 

4400 color filcol,1i,1 

4410 read tnum:poke contr1,é&: poke cont 
r1#2,i:poke contr1+6, tnun 

44260 for tx-@ to tnum-i:iread ascii 
4430 poke intint (tx¥2) ,ascii:next tx 
4440 for tx-1 to tnum:read x 

4450 poke ptsin,x:poke ptsint2,baryt( 
@*Xnody) -2 

44686 Vdisys(1): next tx:color i, i, i:ret 
urn 

4480 SAVEHLOC: 

4490 on x4 goto 4500,4520,4510,4520,45 


4500 hvl(x2)3=x: goto 4526 

4510 hpl(x23=xigoto 45286 

4520 return 

45460 SAVEVLOC: 

4550 on x4 goto 4560,45860,4606,4616,46 


4560 vvl (txti) —bary- (cellh*®tx) :mvl (mv) 
=VV1Ctxt1) imvl Cmutid—vul CtTxt1)-5 

4370 mv=nvtZigoto 4636 

4580 mvl (mvtid-baryit (cel lh*®xi) t (modi- 
72 :mV1 Cav) —baryit (cel lh*®x1) tmodi 

4590 nyv=nvt2:igoto 4636 

a VP1Ctxti}—bary-(cellh®tx) :goto 46 


4610 nvl (avti1)=y1-10:mv1 (nv) YL mU=Mvt 

2:goto 4630 

4626 Dee yee eae See 

4630 retur 

4650 SETMODE: 

4660 color ; 1,i:gosub SETWRITEMODE:co 

lor cl,i,i:return 

4680 WORKDATA: 

4700 data 35,50,51,65,115,130,131,145, 

195,210,211,225 

4710 data 326,350 

4720 data 397,412,413,427 

4730 data 466,595 

4740 data 18,118,123,223,228,328 

4750 data 1,18,1,26,1,18,1,26,1,18,1,2 
27,42,3,18,3,18,43,50 

O34" data 53,58,53,58,51,58 

4770 data 333,66,74,82,90,98,106,114,1 


22 
4790 data 8,0,0,0,16,9, 20, 0,32,8,16,0,8 
9 32,0,16,32,8,16, sz 

800 data 256,1,512 atte 4,2048,8,40 
36. 16,8192, 32, 16334" e4° 32768,128 
4810 data 55,55,54,57 
4830 data 31,100,35,53,32,50,32,79,32; 
83,32,84,32,32,83,32,79 
4840 data 32,85,32,78,32,68,32,32,87,3 
2,65,32,86,32,69,32,83 
4860 data 3,729,708, 70, 38,118,198 
4880 data 6,23,79,67,84,65,86,69 
4900 data 4,70,84,79,78,69 
4920 data 6,104,79,67,84,65, 86,69 
4940 data 4,149,84,79, 78,69 
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4960 data 6,184,79,67,84,65,86,69 

4980 data 4,229,84,73,78,69 

26060 data 8,39,49,50,51,52,53,54,55,56 
9026 data 12,52,49,50,51,52,53,54,55,5 
6,57,49,48,49,49,49,5 

eee data 8,119,49,50,51,52,53,54,55,5 


9668 data 12,132,49,58,51,52,53,54,55, 
96,57,49,48,49,49,49,56 
ee data 8,195,49,50,51,52,53,54,55,5 


5100 data 12,212,49,50,51,52,53,54,55, 
56,57,49,48,49,49,49, 

5120 data 270,1,49,1,50,1,51,3,49,43,5 
0,3,49,43,51,3,50,43,51 

5146 data 5,49,43,50,43,51 

5160 data 3,79,70,70 

5180 data 6,387,67,79,65,82,83,69 

5200 data 4,430, 70,73,78,69 

5220 data 8,401,49,58,51,52,53,54,55,5 


6 
-— data $,416,49,50,51,52,53,54,55,5 


5260 data 10,118,160,118,172,118,184 
5270 data 223,160,223,179,22%,184 
5280 data 328,148,323,160,328.172,328, 


9308 data 186 
9318 data 2,28,152,32,156,32,156,114,1 


5330 data 3,20,170,32,164,32,164,32,17 
@,32,170,114,170 

5350 data 15,20,177,32,181,32,181,32,1 
77,32,177,44,181,44,181,44,177 

5360 data 44,177,56,181,56,181,56,177, 
56,177,68,181,68,181,68,177,68,177 
5370 data 80,181,80,181,80,177,80,177, 
92,181,92,181,92,177,92,177,104,181 
5360 data 104,181,104,177,104,177,114, 
5400 data 2,125,152,137,156,137,156,24 


9,15 

2426 data 8,125,164,137,170,137,176,14 
9,164,149,164,161,170,161,170,173,164 
9430 data 173,164,185,170,185,170,197, 
164,197,164,209,170,209,170,219,164 
9458 data 3,125,177,137,182,137,182,13 
?,177,137,177,219,177 
9470 data 15,231,145,241,141,241,141,2 
41,145,241,145,253,141,253,141,253,145 
2480 data 253,145,265,141,265,141,265, 
145,265,145,277,141,277,141,277,145 
9490 data 277,145,289,141,289,141,289, 
145,289,145,301,141,3801,141,301,145 
299800 data 301,145,313,141,313,141,313, 
145,313,145,323,141 

tag ah 2,231,158,241,153,241,153,32 
9940 data 8,231,170,241,164,241,164,25 
3$,178,253,1780,265,164,265,164,277,178 
99580 data 277,170,289,164,289,164,301, 
170,301,178,313,164,313,164,323,170 
9570 data 3,231,182,241,176,241,176,24 
1,182,241,182,323,182 


& 
ST-CHECKSUM DATA. 
(see page 58ST) 


100 data 279,481,559,359, 369,731,485, 7 
39,226,600,4748 
200 data 698,208,863,531,781,925, 3604, 3 
92,421,353 ,6676 
306 data 363,642,287,185,365,872,518,7 
17,18,913,48686 
406 data 377,482,331,395,841,315,863,3 
43,744,191,4822 
90@ data 858,543,872,452,243,64,552,99 
9,229,976,5788 
9860 data 615,613,338,89,693,936,995, 36 
1,766, 364,5778 
766 data 606,553,560,457,701,261,502,1 
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920 data 565,561,14,992,695,510,621,51 
6,47, 382,489 

1620 data 459,127,57,699,443,102,425,9 
63,656,444,4375 

1130 data 430,231,454,575,235,278,523, 
336,432,812,4293 

1240 data 269,228, 33,391,866,432,316,8 
77,60, 901,4373 

1350 data 174,932,424,395,15,709,923,4 
49, 960,190,5162 

1450 data 261,590,296,648, 904,413,433, 
748,928, 759,5980 

1560 data 504,812, 903,959,385, 908,458,8 
6,320,641,5676 

1680 data 648,141, 715,593,506,638, 746, 
89,280,991,5347 

1780 data 881,403,427,439,977,612,333, 
727,177, 706, 5682 

1896 data 526,477,365,620,618, 708,239, 
348,358, 368,4627 

2000 data 503,440,679,126,475,692,778, 
110,834,4,4641 

2110 data 222,710,866,676,695,503,116, 
837,445,446,5516 

2230 data 3390,418,107,203,649,105,454, 
740,856,442,4364 

2330 data 468,564,10,466,864,455,859,7 
37,878,234,5535 

2430 data 582,881,241,585,891,250,588, 
887 ,250,584,5739 

2530 data 897,260,587, 900,267,368,634, 
826,277,412,5428 

2640 data 872,633,939,269,970, 711,583, 
990,735,575,7277 

2750 data 465,345,844,166,165,171,821, 
600,225,220, 4022 

2860 data 866,430,521,519,522,488, 168, 
426,533,585,5050 

2550 data 396, 976,882,607,314,475,774, 
715,53,569,5761 

3050 data 790,723,448, 881, 846,856,867, 
195,656,757, 7019 

3170 data 750,355,891,418, 710,27,695,5 
81,748,354,5529 

3270 data 888,417,923,712,33,695,583,7 
56,399,894,6300 

3370 data 437,720,37,699,584,754,407,8 
91,429, 931,5889 

3470 data 722,43,706,586, 762,430,897,4 
49,723,40,5358 

3570 data 710,594, 767,431,894,441, 939, 
725,46,710,6257 

3670 data 125,956,834, 724,785,470, 746, 
475,347,99,5561 

3780 data 734,980,287,626,852,564,458, 
433,201,512,5639 

3900 data 268,252,529,307,308,610,612, 
618,984,36,4524 

4020 data 683,817,542,385,825,746,144, 
817,258, 732,5949 

4130 data 164,169,174,166,171,178,183, 
168,173,52,1598 

4230 data 221,922, 768,169,875,358,604, 
699,92,719,5427 

4350 data 378,846,459,353,512,294,217, 
510,580,87,4236 

4460 data 272,807,133,899,888,460,834, 
151,962,628, 6034 

4580 data 724,630, 97,60,519,464,608,23 
1,799, 361,4493 

4710 data 821,592,855,321,47,807,25,44 
1,67,205,4181 

4830 data 987,88,234,464,830,439,843,4 
67,843,994,6189 

5020 data 53,974,29,2,27,39,747,152,44 
9,801,3273 

5220 data 973,983,649,349,248,273,24,4 
87,869,356,5131 

5370 data 357,186,356,544,377,48,567,3 
63,353,693,3849 

5520 data $32,553,329,985,2199 
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STylish Software 


No question about it, the new Atari 520 ST™ is a 
remarkable computer. And nothing complements a great 
computer better than great software and great peripherals. 


HabaWriter™. A full-function word processor, featuring 
windows for simultaneous multiple document editing as 
well as pull-down menus for fast access to program 
commands. Advantageous use of the mouse means never 
having to memorize cryptic commands again. HabaWriter 
is the word processor your 520 ST has been waiting for. If 
you do any writing at all, take a look at HabaWriter. 
Suggested Retail: $74.95 


Habadex PhoneBook™ is the elegant way to store phone 
numbers. And it not only stores numbers, but it can dial 
them as well. It works and looks just like the flip-up phone 
book that you’re used to. Long distance services like MCI 
and Sprint can be automatically dialed so you don’t have 
to. The PhoneBook can sort on any field, is versatile 
enough to handle other types of information and can even 
print mailing labels. (Automatic dialing requires either a 
HabaModem™ or any Hayes™ compatible modem. ) 
Suggested Retail: $49.95 


The new HabaDisk™ 10 Megabyte hard disk for the 520 
ST is a Winchester plug-in hard disk that is capable of 
storing the equivalent of more than 12 dual-sided 800K 
diskettes and retrieves information in seconds (3 msec. 
track-to-track access time). It is self-powered and 
completely Atari ST compatible (including Atari Desktop 
and GEM™ DOS). Suggested Retail: $699.95 


Also available for the 520 ST: 


Haba Checkminder™—Suggested Retail: $74.95 

Haba Mail Room™—Suggested Retail: $74.95 
HabaMerge™—Suggested Retail: $39.95 

Solutions: Wills™—Suggested Retail: $49.95 

Solutions: Business Letters™—Suggested Retail: $49.95 





520 ST is a trademark of Atari Corp. HabaWriter, Habadex PhoneBook, HabaModem, HabaDisk, Haba Checkminder, Haba Mail Room , HabaMerge, Solutions: Wills, and Solutions: Business Letters are trademarks of Haba 
Systems, Inc. Hayes is a trademark of Hayes Microcomputer Corp. GEM is a trademark of Digital Research, Inc. 
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of extraordinary color graphics. Right = Made by Seikosha 
now, there is only one full size, com- 
mercially available color printer that 
can screen dump in over 120 


VIP Professional is our powerful new 
software for the Atari ST. Its program is 
colors off the Atari ST, and identical in features and commands 
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The powerful new Atari ST is capable : . ® Million characters per color ribbon cassette 
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700CI color printer. 


Other features  _— Sort and Query Fields. 
include: . <4 hag" VIP Professional is a trademark 
=# Fast and quiet : \ f VIP Technologies, Lotus 

operation 2-3 S a TOCEMANn O Lotus 
Development Corporation 
| = Uses standard Atari ST 1s a trademark 
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= Centronics interface—compatible 
with many other computers 


VIP 
PROFESSIONAL SPC-700CI 
SPREADSHEET COLOR PRINTER 


$9990 $99995 


Full-Blown Original Version 
pic 


GUMBALL EXPRESS ORDER FORM .- For FAST delivery use this order form or call TOLL FREE 800/423-9442 











Product Description Price P&L TOTAL OO VISA OO MASTERCARD 1) INTERBANK (MasterCard only) 
VIP Professional $ 99.90 $3.50 $103.40 Name on card 
for Atari ST Account # 
Shanner SPC-700CI $299.95 $7.50 $307.45 Expiration Date 
1 Check here and add $14.95 to $399.95 Signature 
; SHIP TO: 
All products will be shipped prepaid UPS ground. 
Name 
1 Check enclosed. (NOTE— order will be shipped when check clears). Address 
ee 





Make check payable to: 
Gumball Express 
707 S.W. Washington Street Suite 200 
Portland, Oregon 97205 


C.O.D.’s and purchase orders will not be accepted by Gumball Express. 
Outside the USA add $10. and make payment by bank draft, payable in 
U.S. dollars drawn on a U.S. bank. 
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by Clayton Walnum 


Before we get started, I’d like to thank everyone 
who's sent me their comments on C-manship. When 
I first started this column, I was a little worried there 
might not be much interest. I’m pleased to report that 
all the feedback has been positive, so I feel this 
column has a secure future. 

If you were thinking of writing, but haven't got- 
ten around to it, please do. I want to hear from you. 
The only way I have of knowing that I’m on the right 
track is from the comments I receive from you, the 
readers. 

While we're on this subject, I got one letter of par- 
ticular interest from Donald Howes, who writes: 

Don't use scanf()!...To make a long story short, 
scanf() can develop a life of its own. It will of- 
ten present you with results completely at vari- 
ance with what you might have expected. This 
is a problem for novice programmers especial- 
ly. They might be a little unsure of what they’re 
doing and could spend needless hours trying to 
debug a simple program, when the problem is 
inherent in scanf{(). It’s a much better idea to de- 
velop your own input routines... 

So we've been warned. Keep that in mind during 
your experiments with C. As I said last month, we'll 
eventually construct our own input routines. But for 
now, we'll treat scanf() with suspicion. 


ST-LOG 





Our current project. 

Okay, fun’s over. Let’s get back to work. Listing 1 
is this month’s program. Type it in and compile it. 
If you need help, see the sidebar accompanying last 
issue’s C-manship article. 

Feeling lucky? Good. Get out all that green stuff 
that’s been cluttering up your wallet and give Lady 
Luck a wink. This month, we're all going to learn 
how to play craps. (I know that was top priority on 
your things-I’ve-got-to-do-today list.) 

Now I admit, this isn’t the most stunning version 
that'll cross your eyeballs, but it’s a good program- 
ming exercise and demonstrates a lot of new tech- 
niques. 

If you already know the rules (that’s where you’ve 
been all those late nights, huh?), skip ahead to the 
next section. For those who've led sheltered lives, 
craps is a dice game which has the dubious reputa- 
tion for making and breaking many a fortune. In our 
case, we'll try to leave your savings intact—only the 
rules remain the same. 

Step one is to roll the dice. If, on your first roll, 
you get a seven or an eleven, you win. A two, three 
or twelve, on the other hand, leaves you the loser. 
If you manage to avoid all lucky and unlucky com- 
binations, you must roll again. . .and continue to do 
so, in an effort to attain one of two outcomes: if you 
reroll your original number, you win; if you get a sev- 
en or eleven first, you lose. 
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The game's afoot (without toes). 

Now that you know how to play, take a moment 
to try the program out. Have a little fun and get a 
general idea of what’s going on. 

Now let’s take a look at the listing. You might want 
to number each line, so you can refer to them more 
easily as we go through the program. Remember, I 
don’t count blank lines. 

I don't think it’s necessary to go through every line 
as we have in the past. I think you’ve had most of 
the basics pounded into your heads, right? Just no- 
tice that we’ve included a couple extra files (osbind.h 
and portab.h) this time around. You’ll see why later 
on. 

Let’s skip ahead to Line 9. You’ve probably noticed 
that I usually use ch as a character variable. This time, 
I have it declared as an “int.” Does that mean that 
I’ve abandoned our poor friend ch to a new and un- 
known fate? No, we're still going to use it to hold 
character information, because it just so happens that 
the only difference between a character variable and 
an integer is the number of bytes taken up in memory. 

If you remember from a few months ago, a charac- 
ter is stored in 1 byte and an integer is in 2. For our 
purposes, the two are really interchangeable. What 
you should be aware of is that, in C, character vari- 
ables are converted to integers for processing, then 
truncated back to a single byte. 

By declaring them as integers in the first place, 
you'll always be reminded of what’s going on in your 
machine’s innards. And you may come across a time 
in your illustrious programming career where the 
difference will be critical. 

Now skip ahead to Line 11. This is the beginning 
of the main game loop. You remember the “while” 
loop, right? The variable we're testing, play, was in- 
itialized to 1 (or true) in Line 10. As long as it re- 
tains this value, the game loop will repeat. 

Notice that we aren’t using the statement while 
(play = = 1). Any nonzero value is evaluated to true, 
therefore play = =1 and play are really the same ex- 
pression. The way to test for a false condition (0) is 
with the not operator: while (!play). 

The game loop is another example of structured 
programming. Each major task of the program has 
been allotted to a function. First we roll the dice, then 
we check to see if the player won, lost, or has to roll 
again. 

If the call to check__roll() leaves the variable win 
in its zero state, then the second while loop is ex- 
ecuted. The dice are rolled until win changes to 1 
(win) or —1 (lose). 
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The variable win is then tested in an “if” statement, 
and the appropriate message is relayed to the play- 
er. The percentage of games won is calculated, and 
the player is asked if he wishes to play again. If he 
answers with a Y, then play remains true and the 
game loop repeats. Otherwise, play becomes false, 
and the program returns you to the desktop. 

Now the details. Start with Line 11. Here we in- 
itiate the main loop. As long as the expression in 
parentheses is true, the loop will repeat. Since we 
initialized play to 1, we enter the loop. 

The first thing we have to do in the loop is initial- 
ize a couple more variables. This is important, since 
the values of first and roll are passed to the function 
that “rolls” our dice. 

The variable first is used as a flag to indicate if 
it’s the player’s first roll. What roll we’re on is im- 
portant. For example, a seven on the first roll is a 
winner. A seven on the second roll is a loser. The 
variable roll will hold the value of the current roll 
(except the first one). Line 14 is to call the function 
roll__dice() and places the value returned in 
first__roll. 

Line 15 calls check__roll() and places its return into 
win. In order to evaluate the player’s roll, this func- 
tion needs some information. We're passing the in- 
formation by giving it the values of first, first__roll 
and roll. 

Line 16 changes the flag first to its false condition. 
If the player neither won nor lost with his first roll, 
then the value of win will still be 0, and the second 
while loop, which begins on Line 17, will be per- 
formed. 

See the win = = 0? Why didn't I use the while (!win) 
construction as mentioned previously? There’s real- 
ly no reason, as far as the program goes. I used the 
former construction to make the program more read- 
able. Using !win might make someone looking at the 
source code think that if win was 0 the player lost. 
This isn’t true. A value of 0 means that the player 
hasn’t won and he hasn't lost. It’s a neutral state. If 
you want to use !win, go right ahead. It’l] work just 
fine. 

Line 19 calls roll__dice() a second time. This time, 
it assigns the value returned to the variable roll. We 
need this second variable, since we need to compare 
the first roll with all subsequent rolls. 

Line 20 calls check__roll() again. If the value of 
win remains 0—meaning the player still hasn't ei- 
ther won or lost his turn—the loop repeats. Once the 
player has managed to make his roll—or has blown 
it, with a seven or eleven—we exit the loop. 


ST-LOG 


Line 22 will increment the game counter, num_ 
games. We'll use this value to calculate the percent- 
age of games won. 

Lines 23 through 29 make up the body of an “if” 
statement. It uses the value contained in win to print 
the appropriate message to the player, as well as keep 
track of the number of wins. 

If win is -1, the player has lost, and the program 
prints You lose—deep, huh? If win equals 1, the play- 
er has won the game, and a statement of equal profun- 
dity is printed (sigh). 

Also, the counter num__win is incremented, keep- 
ing track of the number of games our lucky player 
has managed to be victorious in. We're also calling 
a new library function here, puts(). This function is 
going to print the string argument contained in the 
parentheses. The main difference between the two, 
puts() and printf(), is that the former has no format- 
ting options. 

Last month, we just touched on the format of the 
“if” statement. This month, we're going to look at 
some much more complex examples. The statement 
were looking at now is a slight variation of the one 
we saw in the last installment. The difference is the 
addition of the else portion. 

Thinking back, you’ll remember that the body of 
an “if” statement is performed only when the expres- 
sion in the parentheses is true. When you add the 
else, the rules change just a bit. You now have a kind 
of “either/or” condition. If the expression being tested 
is true, the statements following the if and preced- 
ing the else will be performed. If the expression test- 
ed is false, the statements associated with the else 
are performed. 

The syntax rules for the else are the same as for 
the if. If the body of the else portion consists of more 
than one statement, you must enclose them in brack- 
ets, and—remember—each statement must end with 
a semicolon. 

Line 30 calls the function percent()— which prints 
out the percentage of games won. 

Line 31 calls the function play__again()—to find 
out if the player wishes to continue or quit. 

Digging deeper. 

Now that we've taken a look at the general scheme 
of things, we can get into the details of each function. 

The function roll__dice() does exactly as its name 
implies. The first thing you should take note of is the 
way this function is declared. There’s something ex- 
tra here. See what it is? Up till now, our functions 
have been declared simply by the function name. 
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Now the key word int has been added in front of 
the name. This specifies that the value to be returned 
by the function will be an integer. In this case, we 
could have left it off, since the default is always an 
integer. 

But, if we wanted to return some other data type 
from a function, we must declare the type in the func- 
tion definition and in the calling function. For in- 
stance, if we wanted to return a character from a 
function named ret__char(), we would first declare 
the function type in the calling function like this: 


. int) 
char ret char); 
Then the function declaration might look like this: 


char ret_chartl, b) 
in » b; 

The variables ] and b are the values being passed to 

the function, and are included here only to differen- 

tiate between the two examples. 

Lines 36 through 39 declare some local variables, 
print a prompt, and wait for a key press. 

Line 40 gets a random number and places it in d1. 
Random() is a function specific to the ST and is an 
extension of the BIOS (Basic Input/Output System). 
It returns a 24-bit random number. 

In our case, we need an integer. Take a good look 
at Line 40. See the int in parentheses? This is a “cast 
operator.’ What we're doing is forcing the return of 
Random() into a 16-bit integer, rather than doing it 
implicitly through automatic conversion (just leav- 
ing the cast operator out). In this particular case, the 
statement would’ve worked either way, but sometimes 
the difference can be critical. 

Look at these two code segments: 

int i; 

a= 3.4 + 7.8 

int i; 

i = (int) 3.4 + (int) 7.8 
In the first example, the addition is performed, yield- 
ing a result of 11.2. Then, since the variable i is de- 
fined as an integer, the conversion from float to int 
is done automatically by trucation, making i equal 
to 11. 

In the second example, 3.4 and 7.8 are converted 
to integers before the addition is performed. This 
yields a result of 10. Not quite the same answer. 

Line 41 takes the value in d1 and converts it to a 
positive number between 1 and 6, using modulo arith- 
metic and the absolute value function. 

The abs() function is defined in the stdio.h file. It 
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looks and works exactly the way you’ve grown ac- 
customed to in BASIC, returning the absolute value 
of a single argument. 

The percent sign is the modulus operator. It is used 
only in integer arithmetic and yields the remainder 
when the number on the left is divided by the num- 
ber on the right. For example, the expression 6 % 4 
gives a result of 2. 

So, in Line 41, we're taking the absolute value of 
d1 (in case we got a negative number from Ran- 
dom()), dividing it by six, then adding one to the re- 

‘er. Using six in the modulo math assures us 
always get a remainder less than six (zero 

‘ough five, to be exact). Adding one gives us our 

wll of the die (one through six). 

Lines 42 and 43 get a value for the second die in 
the same manner. 

The function then prints out the value of each die, 
as well as the total. The total (t) is then passed back 
to main(). 


Regent 


Regent Base 


A Full Function Relational Database! 


Regent Base's procedural language make it 
a natural for handling any of your small 
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simple clones of IBM products. Regent Base 
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Line 50 declares the function check__roll() as re- 
turning an integer. Three values are being passed to 
the function. Notice that the variables being passed 
(Line 15) and the variables that are accepting the 
values, have the same names. This is purely for rea- 
sons of clarity. They’re still completely separate iden- 
tities. 

Now look at the body of the function. This is surely 
the most complex piece of code we've tackled yet. 
Basically, the whole thing is an “if” statement, but 
with layer upon layer. This function will give you 
great insight into the problems inherent in nested “if” 
statements. 

Before we get too far into this function, I should 
introduce you to the else if construction. I mentioned 
previously that, with the “if...else” statement, we have 
an either/or situation. The else if takes this one step 
further, and allows us to add a test to the else por- 
tion of the statement. Look at this example: 


if (Cexpi) 
Statementi; 

else if Cexp2Z3 
Statement? ; 


else 
Statements; 


If exp1 is true, statement1 will be executed and the 
elses ignored. If exp1 is false, then exp2 is tested. 
If we get a true result, statement2 is executed and 
the final else is ignored. Finally if both exp1 and exp2 
are false, statement3 is executed. 

In check__roll(), we’re using the flag variable first 
to decide which set of “rules” apply to the player’s 
roll. If it’s his first roll, first will be equal to 1, and 
we'll go ahead and evaluate the second “if” statement, 
which checks to see if the roll was a seven or an 
eleven. If it was, the player wins. The flag wn is set 
to 1, and program execution continues at Line 66. 

See those vertical bars in the middle of Line 57? 
That’s the or operator. Line 57 reads: if first__roll 
equals seven or first__roll equals eleven. The or oper- 
ator yields a true result if one or more of the expres- 
sions are true. Here are a couple of examples. . . If 
we assume that a equals 1, b equals 2, and c equals 
3, then following expressions evaluate as shown: 


a--=i 11 b=-=6 TRUE 
a--4 11 eine TRUE 
a=-=3i f§1 b==Z TRUE 
a--2? I1 sees FALSE 
a==3% 45 Bo=s Ti cxu=z TREE 
a-—i {3 B==5 Tt c==3s TRUE 
a-==2 |] br==3 {1 c==4 FALSE 


Continuing with check__roll(), if the roll wasn’t 
a seven or eleven, we evaluate the else if portion of 
the statement. Here we check for a 2, 3 or 12. If we 
find one of these values, the player loses. 
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The flag wn is set to —1, and, as in the first case, 
program execution continues at Line 66. If neither 
of the previous conditions are true, wn retains its in- 
itialized value of O (Line 54), and, once again, the 
program continues at Line 66—which returns the 
value of the flag to main(). 

Whew! All that’s only if the player's on his first roll. 
If first is 0, program execution jumps to the “else if” 
statement on Line 62. 

Before we continue, I'd like to see if I can help you 
avoid a good deal of teeth-knashing and hair-pulling 
in your future C programming. Look at those brack- 
ets on Lines 56 and 61. They’re absolutely essential 
with nested “if” statements containing else con- 
structions. 

Without those brackets, the compiler has no way 
of knowing that the last two “else if” statements go 
with the outer “if” and not the inner. Keep in mind 
that the indenting is only cosmetic; it means abso- 
lutely nothing to the compiler. This is an easy trap 
to fall into, since the indenting makes everything so 
clear to the programmer. 

Now let’s take the second possible path in this func- 
tion. If first is 0, all the stuff between the brackets 
is skipped, and we continue at Line 62. This line 
checks to see if the player’s roll was equal to his first. 
If it was, wn is set to 1 (win), and its value is returned 
to main() at Line 66. 

If the first condition isn’t true, we drop down to 
test the second. Line 64 checks for a roll of seven 
or eleven. If it evaluates to true, wn is set to —1 (lose) 
and its value is returned at Line 66. 

If none of the above conditions are met, the only 
thing that happens in this function is wn is set to 0 
(Line 54) and its value is returned to main() (Line 
66). The player has neither won nor lost, and must 
roll again. This process repeats until wn—and, sub- 
sequently, win—gets a nonzero value. 

Moving on, Line 68 defines the function percent(). 
The word VOID in front of the function name indi- 
cates to the programmer that the function doesn't re- 
turn a value. Like the int, it could’ve been left off. 

VOID is defined in portab.h, which we included 
at the beginning of the program, and is really just 
an empty comment. In other words, even though 
we've declared percent() as VOID, it’s still capable 
of returning an integer value. We're declaring it this 
way for the sake of clarity only. 

This function does nothing more than calculate the 
percentage of games won and print the result out to 
the player. A few things should be said about Line 
72, though. 
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First of all, in case it isn’t obvious, the “/” (not to 
be confused with “\’) is the division operator. The 
value on the left of the operator is divided by the value 
on the right. 

You'll notice that the integer variables num__win 
and num__games are being cast to floating point. 
This is critical in this calculation. When you divide 
integers in C, you get an integer result; the decimal 
portion is truncated. If we allow this to happen with 
our percent calculation, we'll get two possible results, 
only one of which will be accurate. If we’ve won ev- 
ery game, then num__win/num__games will give us 
1, which multiplied times 100 equals 100%. Fine and 
dandy. 

But what happens if we’ve only won one game out 
of two? In integer division, num__win/num__games 
will give a result less than 1. When the decimal por- 
tion is truncated, we'll end up with 0. And what’s 
O times 100? It’s certainly not 50%, the result we 
want. 

Okay, we’re almost done. Just one more function 
to take a look at. The function play__again() is 
responsible for finding out if the player wants to play 
another game. There’s really nothing very new here. 
Something that we had a brief encounter with was 
the way we're using getchar() in Line 80. We could 
rewrite this line as follows: 

ch = getchard); 
if (ch == '¥' Pf ch == '"y"') 

One of the neat things about C is the way you can 
cram a lot of stuff on one line. Here, getchar() is called 
and its value is compared to the character Y. The vari- 
able ch now contains the value returned by getch- 
ar(), and it’s compared to the character y. 

If either of these compares finds a match, then the 
flag p is set to its true condition and returned into 
play, to be evaluated at Line 11. This way, the game 
repeats until the call to play__again() results in a 0. 


Breathing time. 

That’s it—class dismissed. If any of the program 
is still fuzzy to you, study up on it, especially the 
function check__roll(). When you feel you’ve got it 
all down pat, try your hand at writing a simple game. 

How about that classic guess-the-number game? 
It should be fairly easy. Have the computer pick a ran- 
dom number between 1 and 100. As the player tries 
to guess the number, have the computer tell him 
whether he’s too high or too low. 

As for me, C you later. (Sorry about that.) A 





(Listing begins on next page) 
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} 


} 





Binclude <stdio.h> 
Rinclude <osbind.h> 
Binclude <portab.h> 


main 
{ 


ant first_roll, win, roll, play, first; 
int nuM_winh = 6; 

ant num_games = @; 

ant ch; 


Play = 15; win = 6; 
white (play) 


first <= nt roll = = 0; 


first_ rol roll_diced; 

win = check_roll (first, first_roll, roll); 
first = @; 

lai aa (win == 6) 


roll = roll_diced; 
a = checkroll (first, first_roll, roll); 
*tnum_games; 
if (win == 
puts("You lose. ‘"); 
—— 


++nuMm_win; 
uts("You win! ); 


percent (num_games, nNum_win) ; 
era = Play_again(); 


} 
er roll_dice( 


ant di,d2,t; 
int ch; 


Puts ("Press space bar to roll\n"'); 


ch = getchar 0); 

di = Cint) Randong; 
di = abs(di) % 6 + 4; 
d2 = (int) Random ; 
d2 = abs(d2) % 6 + i; 


printf ("Die Ri: Me ", did; 
prantf ("Die #2: Zd\n\n", 42); 
t= di ¢ d2; 

printf (Your roll: Z“d\n\n", 3; 
return (t); 


int check_roll(first, first_roll, roll) 
;** farst, first_roll, roll; 


int wn; 
wn -— 60; 
if (first == == §) 
if ee Foil == 7 I] first.rell == 113 
wn - ‘ 
else if (first_roll == 2 I] first_roll == 3 |] first_roll == 12) 
wn = -1; 
else iff (first_roll == roll) 
wn - 1; 
else if (roll == 7 ti Fall <= 22) 
wn =i % 


return (wn); 


VOID percent (numM_games, num win) 
int numM_games, NUM_Win; 


float Pc; 
pc = (Cfloat) numwin / (float) num_games) * 100.86; 
printf ("You've won “%~d %~% of the games\n", (int) pc); 


-=* Play_again (©) 


int Pp; 
int ch; 


puts ("Play again? ""); 

if (€(€ch = getchar(}) == ‘¥' [| ch == ‘'y*) 
P= 1; 

else 
P = 6; 

Puts ¢'A\n\n"); 

return(p); 
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Word Processing 


on the 


Atari 520ST 


by Arthur Leyenberger 


The 16-bit Atari ST has been available 
to the public for nine months now, and 
there’s no denying its success. The rea- 
son for its popularity is largely due to 
the amount of software available for the 
machine. 

There’s no category of software more 
widely used than word processing pro- 
grams, regardless of which computer we 
talk about. This applies to the Atari ST, 
as well. Fortunately, there are plenty of 
programs to choose from, as you’ll soon 
discover. 

The business of processing words is 
relatively straightforward on most com- 
puters. Sure, some programs offer a few 
more features here, or an easier-to-use 
command set there, but, for the most 
part, if you’ve seen one word processor, 
you’ve seen them all. 

However, with the introduction of 
computers like the Apple Macintosh— 
and now the Atari ST with its GEM 
interface—the business of processing 
words has, at least potentially, been 
made easier. 

There are five word processing pro- 
grams for the ST, which can be catego- 
rized as either “text-based” or 
“GEM-based.” Text-based programs 
function like about any other word 
processor on any computer; they display 
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only text on-screen. They typically re- 
quire you to use commands or respond 
to menus, in order to edit, format and 
print your documents. 

The GEM-based programs use the 
natural interface of the GEM desktop, 
with its icons, drop-down menus, win- 
dows and mouse control. The mouse 
may seem awkward at first. Some peo- 
ple claim that, since using a mouse re- 
quires that your hand leave the 
keyboard, it takes more time to use the 
mouse than it saves. 

However, with a well-designed set of 
commands, a word processor that allows 
use of a mouse can be easier than a text- 
based program. After a couple hours of 
mousing around, most users find that 
they’re accustomed to manipulating the 
mouse—it eventually becomes quite 
natural. 


Text-based word processors. 

ST-Writer — In the beginning, Atari 
said, “Let there be an ST.” And there 
was, and it was good. Then the users 
said, “Let there be a word processor for 
the ST.’ And there wasn’t, and it was 
bad. Then Atari scrambled; ST-Writer 
was the result—the first word proces- 
sor for the ST computer. 

ST-Writer is an all-text word proces- 
sor, based primarily on the highly-rated 
AtariWriter for the 8-bit computers. 
AtariWriter has been around for a cou- 


ple years now and has proven itself with 
many 8-bit owners. Anyone familiar 
with the program will find ST-Writer 
easy to slip into, comfortable as an old 
pair of slippers. 


Instead of using the START, SELECT 
and OPTION keys of its predecessor, ST- 
Writer takes advantage of the ten func- 
tion keys located across the top of the 
keyboard. The ESC, CTRL and ALTER- 
NATE keys are also used, either in- 
dividually or in conjunction with one of 
the function keys. Of course, the major 
difference is the eighty columns of text 
across your RGB or monochrome moni- 
tor screen. 


On a color monitor, the control codes 
(used for special printer codes, end of 
paragraph carriage returns and option 
settings) are easily found, displayed in 
red. At the top of the ST-Writer screen 
is the command line, with red letters 
and white numbers. The screen is clear, 
too, with text in white on black—or the 
reverse, if you like. 

On a monochrome monitor, text can 
also be displayed in either white on 
black or black on white. And, when us- 
ing ST-Writer with a monochrome 
screen, you can choose to display either 
20 or 40 lines on-screen at once. 

There are a number of improvements 
Atari’s made over the original. From the 
menu screen, you can now: format a 
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* LogiKhron Clock Card * Are you tired of resetting the date and time when the Atari ST is 
turned on? Then LogiKhron is for you! It automatically enters the date and time into the 
Atari ST each time the computer boots. Through the use of an internal battery, LogiKhron 
maintains the precise time and date even when the computer is off. Installation is easy, just 
insert LogiKhron into the left cartridge slot and enjoy the benefits. — Only $49.95 


* Electro Solitaire & 21 * Transform your computer into the perfect card playing friend. Why 
hassle with searching for a deck of cards, shuffling, and dealing if your computer can do it 
for you? Electro Solitaire & 21 adds a new dimension to the ever popular games of Solitaire 
and Blackjack. Just think, point, and play; it’s as easy as that? — Only $19.95. 


* The Study Guide * The Study Guide is a carefully designed educational tool. You enter 
the information which you want to learn and the computer helps you learn it. Questions are 
then organized into formats such as multiple choice, true/false, essay, or fill in the blank. 
You can then compare your answers against the computer’s to evaluate your success. For 
ages 11 to Adult. —$39.95 


* Electro Calendar * Electro Calendar is an enhanced version of your wall calendar. You 
can store and retrieve important messages quickly and easily. For instance, it can remind 
you of upcoming meetings, birthdays, anniversaries, or any important event. If your wall 
calendar becomes outdated, let Electro Calendar print one for you. It will display or print 
calendars between the year 0001 and 9999. — Only $39.95 


For more information or to place an order, 
call (314) 894-8608. Dealer inquiries invited. 


sorry, no Visa or MC accepted. 








2 ™™ 
Soft Logik Corp. 4129 OLD BAUMGARTNER « ST. LOUIS, MO 63129 « (314) 894-8608 
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disk; print to either the screen, a disk 
file or a printer; and receive files directly 
transmitted from an 8-bit Atari. 

In the edit screen, the number of free 
memory is always displayed—over 
150-thousand bytes free with RAM TOS, 
or over 350-thousand free bytes with 
TOS on ROM. Further, you can mark 
blocks of text and save them to disk. 

There are other ST-specific features 
worthy of note. The program allows you 
to use files located in subdirectories, on 
any disk, and it automatically keeps 
track of which directory you’re looking 
at when doing a file save or a disk index. 


ee inet Ole 
ress ESC te reture te mens. 





ST-Writer. 


ST-Writer is a what-you-see-is-what- 
you-get word processor. You can, there- 
fore, see on-screen how single- or double- 
column formatting will look before you 
print it out. ..a very useful feature. 

Documentation consists of several files 
as freely available as is the program it- 
self. There are tutorial, reference, quick 
reference and function key label files 
available. 

In addition, a couple of other files are 
needed before the program can be effec- 
tively used. There’s a configuration pro- 
gram that uses a specific configuration 
file to create the “XYZZX” printer driv- 
er file that ST-Writer looks for when told 
to print. If you’re familiar with ASCII 
printer control codes, you can modify 
the source driver file so that ST-Writer 
works with your non-Epson-compatible 
printer. 

ST-Writer contains just about every 
feature most users would need. There 
are a few commands not offered—like 
ability to move the cursor from word to 
word or paragraph to paragraph, the 
ability to delete a word or paragraph at 
a time, or the capability to use multiple 
windows for text. 

And there are a few problems with ST- 
Writer. For example, cursor movement 
is slower as your file gets bigger. There's 
a lengthy conversion time required to 
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import a non-ST-Writer file. For a seem- 
ingly small file, it can take a couple 
minutes for the screen to return to 
normal. 

There are also a few bugs that mys- 
teriously lock up the computer at times 
—and, just as mysteriously, have no ef- 
fect at other times. 

One of the bugs rears its ugly head 
when you try to print double-column 
output. It seems, when a carriage return 
occurs at the end of a paragraph in the 
left column, the right column margins 
get out of sync. Another bug prevents 
you from blocking the headers flush 
against the right margin. In fact, I’ve had 
some problems trying to print headers 
in general. 

ST-Writer appears a reasonable choice 
for a word processor, considering its 
price and availability. Unfortunately, 
Atari’s limited resources will probably 
prevent them from correcting bugs or 
adding features regularly. So, although 
it’s free, you must decide if you want to 
trust your important word processing 
work to a program which Atari has no 
stake in maintaining or improving. 


Regent Word. 

While various versions of ST-Writer 
were making the rounds, Regent Word 
appeared on the scene, an easy-to-use 
but powerful word processor. Regent 
Word is from the same folks who devel- 
oped AtariWriter and AtariWriter Plus 
—Regent Software. 

The program is billed as the first full- 
function word processor for the ST com- 
puter. It was surely one of the first and 
is clearly full of features. 

Regent Word is menu driven and will 
work on either a monochrome or RGB 
monitor. One of its key features is the 


built-in “help” function. By pressing 
HELP on the keyboard, the user can dis- 
play one of five menu screens at any 
time. Pressing the SPACE BAR cycles 
through the menus, and the UNDO key 
exits the menus. 

The multiple menus in Regent Word 
aren't menus per se. Rather, they’re help 
screens that tell you what the com- 
mands are. Since most commands are 
invoked by a single keystroke, the com- 
plexity of help menus and commands is 
not burdensome. 

Commands are issued by a variety of 
two-key presses with the ALTERNATE, 
CTRL and ESC keys. Also, function keys 
across the top of the keyboard have been 
defined for block operations. 

Like other ST word processors, Re- 
gent Word offers 80-column editing and 
the usual. The RETURN key is used 
only at the end of a paragraph; word 
wrap occurs at the end of each line; and 
DELETE and BACKSPACE work as ex- 
pected. 

The cursor can be positioned through- 
out text by a character or screen at a 
time. In addition, you can move direct- 
ly to the top or bottom of the text with 
one command. 

The print preview function shows 
how your underlined, elongated and 
bold print will look before you actually 
print it. Super- and subscripts, headers, 
footers, justification and page number- 
ing are also supported. 

Much like AtariWriter word proces- 
sors, Regent Word allows you to access 
all the features of your printer control 
codes and options. Using CTRL and var- 
ious letters, such attributes as line spac- 
ing, print style, centering, headers/ 
footers, margins and justification can be 
set. In addition, specific ASCII printer 
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Data Communications tor the Atari™ 520ST 
$39.95 


VT52 Emulation 
Autodial/editor 


Setup files 
Atascii Emulation 





User Group Discounts 
Kermit Dealer Inquires Invited 


Commnet Systems 
7348 Green Oak Terrace 


Macro Keys 
Dos Functions 
Xmodem/Amodem 


Print logging 
300-9600 





Lanham, MD 20706 
(301) 552-2517 


Coming in February: FoReM ST Bulletin Board System for ATARI™ 520ST 
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codes can be sent directly to the printer 
from anywhere in the document. 

A number of features in Regent Word 
are especially useful and well imple- 
mented. When the program’s first run, 
you're asked to enter the date and time. 
Given the lack of battery backup and the 
unreliable clock in the ST, this feature 
ensures that any files created or edited 
with Regent Word will have the correct 
date and time stamp. During editing, the 
time is continually displayed at the top 
of the screen. 

When loading a file, all files on the 
current disk are displayed on-screen, 
with a letter next to each. Pressing the 
letter corresponding to the file you want 
will load that file into memory. In addi- 
tion, the directory also shows total stor- 
age available on the disk, plus creation 
dates and sizes of individual files. 


REGENT WORD Copyright 1985 Regent Software 


Fl = Load file 
F2 = Save file 


= Define search phrase 
= Search for phrase 
= define replace phrase 


= Define beginning of block 
= Define end af block 


= Define end of block & delete block 
= Paste block 


16 = Erase file in memory 


BACKSPACE = Backspace 
DELETE = Delete character 


HELP = Show this menu 
UNDO = Go to edit mode 
SPACE = Show next menu 





Regent Word. 


Another useful Regent Word feature 
is its ability to give you a word count 
of the file currently in memory at any 
time. The program also has a built-in 
communication feature, allowing docu- 
ments to be sent or received via the com- 
munications port on the ST. 

Currently, Regent Word is designed 
for Epson dot-matrix printers (or com- 
patibles) and the Juki letter-quality print- 
er. The program will use however much 
memory is available (an Atari 520ST 
with TOS in ROM yields almost 400K 
free for text files). Also, the size of the 
document does not affect cursor speed. 

Copy protected Regent Word sells for 
$50. Fortunately, a backup disk can be 
ordered in either single- or double-sided 
versions for only $5.00. Still, there’s no 
way to put this word processor on your 
hard disk. Overall, Regent Word is a 
powerful, easy-to-use, text-based word 
processor, just as advertised. 

Regent Software also has a product 
called Regent Spell, a 30,000-word spell- 
ing checker that can be used with Re- 
gent Word or other word processors. As 
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carefully designed and thought out as 
Regent Word is, though, Regent Spell 
seems the opposite. Perhaps it was 
rushed to market. 

It’s not that the program has bugs. On 
the contrary, it’s fast and seems bug-free. 
The problem lies with the number of 
small irritations and feature omissions. 

For example, there’s no way to quit a 
spelling check before the program has 
reached the end of the file. And, since 
there’s no word count or visual indica- 
tion of progress, you have no idea how 
long the check will take. 

Further, there’s no display of the file- 
name and no method to return to the last 
word checked. Regent Spell is a one-way 
program. There's no mass dictionary up- 
date, to let you take a file you know is 
good and have it added to the program’s 
list of words. 

Finally, although you can use some 
features of the program from the mouse, 
you must leave the mouse and press RE- 
TURN after clicking on INSERT or DE- 
LETE. 

Regent Spell sells for $40 (from Regent 
Software, 7131 Owensmouth, Suite 45A, 
Canoga Park, CA 91303 — (818) 883- 
0951) and is copy protected. As it stands 
now, the program works, but the num- 
ber of irritations makes it difficult to use. 
In discussing these problems with Regent 
Software, I was assured that most (if not 
all) of my complaints would be incorpo- 
rated into the next version of the pro- 
gram. 

I have no reason to doubt their word. 
If these and a few other minor changes 
are made, Regent Spell could well be the 
de facto spelling checker for the ST. 


Final Word. 

It’s somewhat difficult to describe 
Mark of the Unicorn’s Final Word. 
Frankly, I don’t know where to start. The 
program's a sophisticated word proces- 
sor that’ll probably require a substantial 
hunk of time to master. But, having 
digested the tome-length documenta- 
tion, you'll find yourself amazed by the 
power at your word processing finger- 
tips. 

‘Final Word comes with almost 500 
pages of documentation accompanying 
the two single-sided program disks. Part 
of this is a 150-page tutorial that must 
be followed chapter by chapter if you ex- 
pect to get anywhere past turning on 
your ST. 

In addition, a terse, 4-page installa- 
tion guide tells you how to get this pro- 
gram up and running. The only specific 


reference to the Atari ST occurs in this 
little guide. As with the PC version (the 
original), the whole kit and caboodle 
comes in an attractive black slipcase. 

One of the unique aspects of Final 
Word is that it’s crashproof. Unlike other 
word processors, where you could lose 
your work, Final Word automatically 
saves your work into a buffer file when- 
ever you stop typing for a period of ten 
seconds. If your computer loses power, 
all you’ve lost is ten seconds’ work. 

Another feature is split-screen editing. 
With a single command, you can split 
the screen into two parts. And, since Fi- 
nal Word can edit up to twelve docu- 
ments at once, you could display parts 
of various files in one window, while 
editing your document in the other. Or 
you could keep a rough draft in one 
window as you polish off the final ver- 
sion in the other. Text can easily be co- 
pied or moved between windows. 

Final Word is really two word proces- 
sors in one. Either may be chosen, based 
upon the needs of the task at hand. The 
on-screen Editor is a what-you-see-is- 
what-you-get word processing editor. 
You type and edit the text on-screen, 
and it appears exactly as it will on the 
final, printed copy. 

The other editor, called the Advanced 
Formatter, allows you to specify how 
your finished documents will look, by 
including formatting commands in the 
body of the document. 

These commands are inserted into the 
document as you type and edit, but 
you'll only see how it looks when the 
document is printed. With the Ad- 
vanced Formatter, you can produce seri- 
ous writing, including table of contents, 
index and footnotes. 

Final Word contains a series of me- 
nus, grouped into a main menu and ten 
function menus. The main menu lists all 
submenus. When displayed, it partially 
obscures your text. After you’re famil- 
iar with the program, you can turn the 
menu feature off. 

After a brief exposure to Final Word, 
you'll get used to seeing the message 
swapping, which occasionally flashes at 
the bottom of the screen. When this 
message is displayed, the program is 
copying the text from memory into a 
disk file called the “swap file.” 

Swapping is automatic whenever you 
stop typing for ten seconds. You can 
change the time interval to suit your 
needs. It’s this swap file that contains 
your text—when the power fails, the 
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computer crashes, or you forget to save 
a file. Should you need to retrieve lost 
text, a recover program is run to re- 
establish where you left off. 

Final Word is truly a powerful pro- 
gram. For the power writer, or someone 
who needs sophisticated word process- 
ing features, this one should be suf- 
ficient. 

Some of the program’s heavy duty fea- 
tures include: precise control of head- 
ers and footers; the ability to place 
footnotes at the bottom of each page, at 
the end of the document or embedded 
in the same line as their reference; au- 
tomatic chapter, section and “new page” 
formatting controls; the ability to cre- 
ate lists, numbered or not, within the 
body of the text; and the ability to cre- 
ate a table of contents and index. 

The Final Word tutorial is what makes 
this complex program manageable. Al- 
though a little chatty at times, it uses 
good training techniques—beginning 
each section with a list of objectives, 
providing plenty of examples during the 






you've created. 







basis. It lets you: lay down 
solid or transparent 
figures to build 
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There is a difference between paint 
and draw programs. Paint programs 
are recreational packages that 
_— allow freeform painting on a dot-by- 
= Yj dot basis. With each new stroke you 
_ obliterate everything you cover. And 
erasing permanently removes everything 


An object-oriented drawing program like 
Easy- Draw is a versatile, powerful tool you use to 
create business graphics, presentation 
materials, line drawings complex 
illustrations on a figure-by-figure 











tutorial, then summarizing what was 
learned at the end of the section. The 
reference manual is complete, too. 

There are a few flaws that you should 
be aware of. The program is copy pro- 
tected. You can run it from a copy, but 
one of the two original disks (used as a 
“key disk”) must be in drive A whenev- 
er you start up. Fortunately, the ability 
to change just about every parameter and 
option of the program allows you to put 
the multitude of necessary programs on 
a double-sided disk or, better yet, a hard 
disk. 

Another problem: for all its power, Fi- 
nal Word does not allow double-column 
printing. Newsletter editors should look 
elsewhere if that’s a major requirement. 
Further, the manual assumes you’re 
working on a CP/M or MS-DOS system. 
For the uninitiated, this could be a lit- 
tle confusing. 

Probably the most serious weakness 
in the program is the extremely tedious 
setup—and the sheer number of pro- 
gram files. To get to the point where you 
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professionals. 
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Draw 


composite drawings * size, move and manipulate 
objects individually and collectively « use a grid 
system for controlled, precise scale drawings 

¢ produce print- outs with accuracy 
exceeding your screen images GanETON games 
* create custom drawings easily. Pas 
Ask your dealer for 
Easy- Draw, the drawing 


MIGRAPH ™ 

720 S. 333rd St., Suite 201 
Federal Way, WA 98003 
(206) 838-4677 


Easy-Draw is a registered trademark and Migraph is a trademark of Migraph, Inc. 


can just type one word from within the 
program requires a seemingly endless 
checklist. And heaven forbid you should 
need to recover a file. The first few times 
you try to run “recover,” you’ll be quiver- 
ing in your boots. 

Final Word sells for $125 and works 
with a variety of dot-matrix and letter- 
quality printers. Although it can be used 
with a single disk drive, the less patient 
Atari ST user will opt for two drives or 
a hard disk. 

If you need the word processing pow- 
er to go along with your “Power with- 
out the Price,’ Final Word is the only 
current alternative. It’s available from 
Mark of the Unicorn, 222 Third Street, 
Cambridge, Ma 02142 — (617) 576-2760. 


GEM-based word processors. 

HabaWriter is the first GEM-based 
word processing program for the Atari 
ST. All the features of the GEM inter- 
face—like drop-down menus and mouse 
control of the cursor—are available. 

However, the first release of the pro- 
gram, version 1.0, was somewhat “bug 
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gy.’ Files were occasionally lost, the 
screen froze, and the cursor tended to 
disappear. Fatal bugs have been elimi- 
nated in version 1.1 and a number of en- 
hancements made to the program. This 
review is based on version 1.1. 

HabaWriter is copy protected, but you 
can copy the program files to another 
disk. As long as the original disk is in 
drive A when you start the program, it 
will start. ..then you can remove the 
original “key disk.” 

When the program begins, a familiar 
GEM window appears on-screen, with 
a menu bar across the top. Desktop ac- 
cessories are available under the “desk 
menu,” assuming the .ACC files were on 
your disk when you first booted up your 
ST. 

The menu bar contains HabaWriter 
commands, and each menu has related 
commands. The menus labeled File, 
Edit, Search, Format, Style and Print are 
all descriptive of commands they con- 
tain, and everything is logically laid out. 
The function keys on the ST keyboard 
can also be used to select commands. 

The HabaWriter document window is 
a regular Atari ST window. You can 
change its size, move it around the desk- 
top and close it by clicking on the close 
box. 

You can also use the vertical and 
horizontal slider bars to move through- 
out the document currently in the win- 
dow. Up to six windows can be open at 
a time, and there's a clipboard for cut- 
ting and pasting parts of (or entire) doc- 
uments. 

To load a previously created file, the 
user selects the “open” command from 
the File menu. A GEM file selector box 
appears, and a file can be chosen, or the 
drive and directory can be changed. 

As the file loads, a small, square box 
much like a meter appears on-screen, 
showing the progress of reading the file. 

HabaWriter lets you work with many 
documents at once. The procedure for 
opening another existing document is as 
described above, or you can create a 
new document. 

The multiple window technique is 
very handy for taking notes while you’re 
writing. As you think of ideas you want 
to save, you can click on your other win- 
dow, type your thoughts and return to 
the spot where you left off. 

You can copy or cut and paste text be- 
tween or within documents. Once the 
text is highlighted, by dragging the 
mouse from start to end, the block can 
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be moved directly to another location or 
document, or to the clipboard. An en- 
tire file can also be pasted into a docu- 
ment. 

The .document format can be set, 
changed and even saved with the file. 
Each time the document’s loaded in the 
future, settings will be loaded along 
with the text. 

Margins, indentation, justification, 
type styles, tabs and preferences can all 
be specified. HabaWriter supports AS- 
CII or “word processing mode” files, and 
sub- and superscripts. 

There are a few features HabaWriter 
version 1.1 lacks. Currently, there’s no 
way to change the line spacing to any- 
thing other than single-space mode. 
Headers and footers aren’t supported. 
There are no fonts at this time—just un- 
derline, bold and normal text. 

The program has trouble reformatting 
paragraphs or documents in ASCII 
mode. In fact, the feature only works 
properly in “HabaWriter” mode on text 
entered with the program. The Search 
and Replace function can’t handle AS- 
CII characters like carriage returns 
(CTRL-M). 

The DELETE key on the ST keyboard 
does not work (frustrating!), and, final- 
ly, there’s no index in the 46-page 
manual. 

On the positive side, Haba is making 
an effort to produce quality software. 
Version 1.1 of the program corrected ear- 
lier bugs and added features, such as the 
ability to create your own printer con- 
figuration file, the ability to send ASCII 
printer codes to the printer, and sub- and 
superscripts. 

I’m told that version 1.2 of HabaWriter 
will have variable line spacing, headers 
and footers, and multiple printer config- 
uration files on the distribution disk. 

I'd also like to mention Haba’s on-line 
support on CompuServe. Gerry Hum- 
phrey from the product development 
staff is very active on the 16-bit SIG (pcs 
58). 

Not only does he answer all questions 
courteously, but he’s interested in feed- 
back on this and other Haba products, 
so they can be enhanced to give you the 
best products possible. If you have any 
questions, suggestions or complaints on 
HabaWriter, leave Gerry a message. He'll 
get back to you quickly. 

The on-line customer support provid- 
ed by Haba is another indication that 
Haba wants to be your word processing 
company. I don’t know of any other com- 


pany currently marketing a word proces- 
sor for the Atari ST which provides this 
level of support. Given the current ver- 
sion of the program and the planned 
changes, HabaWriter could easily be- 
come the ST word processor for a lot of 
people. 

HabaWriter works in either high or 
medium resolution on the ST. The pro- 
gram lists for $80, and Version 1.2 
should be available by the time you read 
this. Existing owners can receive an up- 
grade by sending $7.50 and their origi- 
nal disk to Haba Systems, 6711 Valjean 
Avenue, Van Nuys, CA 91406 — (818) 
901-8828, attention Technical Support. 
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1st Word. 


1st Word is a GEM-based word pro- 
cessor developed by GST Holdings, Ltd., 
an English company. The program was 
originally provided free by Atari for ST 
purchasers during the Christmas 1985 
season. It’s now sold separately for $40 
and is still being marketed by Atari 
Corp., 1196 Borregas Avenue, Sunnyvale, 
CA 94086 — (408) 745-2021. 

Like HabaWriter, 1st Word takes full 
advantage of user-oriented GEM features 
like drop-down menus, icons and win- 
dows. Editing tasks, such as cut and 
paste or changes in document layout and 
style, can be performed with the mouse. 
The documentation consists of a 42-page 
file on the program disk. 

1st Word isn’t copy protected, so it can 
easily be placed on the higher capacity, 
double-sided disks or a hard disk. The 
program works in low, medium and high 
resolution, but only medium- and high- 
resolution screens will provide you with 
80-column text format. 

A number of files come on the distri- 
bution disk. In addition to the 1st Word 
program and resource file, there’s a pro- 
gram called ist Print, to allow you to 
print while using 1st Word. You can’t 
print a file while there’s an open win- 
dow on-screen, though. Trying to run 
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the printer program from the GEM desk- 
top will not work. 

There’s a user guide file and short “tu- 
torial file’ that’s nothing more than a 
short example. Three printer drivers — 
Epson, Qume and plain ASCII—are in- 
cluded on the disk. 

In addition, an install program’s avail- 
able, to let you create the necessary 
printer driver file after you’ve edited the 
hex source file. This program creates ei- 
thera .DOT or a .DSY file, for use with 
dot-matrix or daisy-wheel printers, 
respectively. 

The operation of 1st Word is quite 
similar to that of HabaWriter, with a 
couple notable exceptions. In addition to 
the menu bar at the top of the screen, 
which contains various commands in 
separate drop-down menus, there's a set 
of function key icons across the bottom, 
to indicate the word processing func- 
tions assigned to each function key. 

Keys F1 through F5 indicate toggle 
settings of bold, underlined, italic, light 
and insert mode. The other five keys per- 
form actions when editing: line dele- 
tion, new page, line centering, and 
paragraph indenting and formatting. 

A particularly useful feature of 1st 
Word is that these function keys can be 
operated either from the keyboard or by 
clicking the mouse on the appropriate 
key icon. 

Another significant difference be- 
tween HabaWriter and 1st Word is the 
font table on-screen, partially obscured 
by the primary GEM window. This ta- 
ble holds the ST character font, which 
may vary from country to country. Since 
not all the ST’s 256 characters are avail- 
able from the keyboard, this table allows 
you to select any character you want, 
simply by clicking the mouse on the cor- 
rect position. 

1st Word will copy that character to 
your window at the current cursor po- 
sition. This font table is only available 
in medium and high resolution. 

There are a few things I don't like 
about 1st Word. . . Like HabaWriter, it 
only lets you single-space documents. 
The program also has problems refor- 
matting text from an ASCII file. And 
there’s a silly page eject each time you 
print a document, which can’t be sur- 
pressed . There are no extra fonts (like 
Macintosh uses) available for the 
program. 

On the favorable side, 1st Word allows 
the use of headers and footers, although 
they can only be one liners. The program 
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supports page numbering, conditional 
page breaks, the use of position markers, 
and cut and paste operations. As men- 
tioned before, it’s not copy protected, so 
it can easily be backed up and installed 
on a hard disk. 

1st Word is an easy-to-use and capa- 
ble word processing program for the 
Atari ST. I’m sure we'll see more 
sophisticated GEM-based word proces- 
sors become available, but, until then, 
1st Word will let you do a lot of writing. 

GEM Write is a word processor for the 
ST, which has been promised since the 
ST was first announced. Atari said that 
several GEM programs would be avail- 
able when the computer hit the streets 
in the summer of 1985. Similar to the 
Apple Macintosh, which comes with a 
decent word processor and drawing pro- 
gram, the ST was to arrive with some 
software. But, somewhere between there 
and here, the GEM programs got way- 
laid. 

For the last several months, I’ve been 
repeatedly asking both Atari and Digi- 
tal Research when we could expect GEM 
Write and GEM Draw. Both have been 
available for the IBM PC market for quite 
a while. 

The response I get from either party 
is the same—it’s the other guy who's 
holding things up. 

If you believe the scuttlebut, Atari 
wants to pay a lower price than they first 
agreed to (seems believable). And DRI 
wants Atari to pay them for some other 
stuff, before they turn over the programs 
(also believable). 

The debate won't be settled here. Hav- 
ing used GEM Write on a PC, and as- 
suming that it'll appear for the ST 
sometime, I thought it would be appro- 
priate to give it a brief mention here. 

GEM Write looks like HabaWriter and 
1st Word, but isn’t as functional. Sure, 
it uses a mouse and windowing environ- 
ment like the others, but it allows only 
one open window at a time. You can’t 
do something as rudimentary as mixing 
formats to produce, say, a single-spaced 
paragraph in a double-spaced document. 
Also, there’s no way to pass control 
codes to your print or delete files from 
within the program. 

GEM Write allows you to use either 
drop-down menus or CTRL-key se- 
quences for issuing commands. The lat- 
ter are very similar to those used by 
Wordstar, a popular word processor for 
the PC. GEM Write supports pagination, 
justification, single-line headers and 


Atari ST Software 


MICRO C-Shell $49.95 
Unix style C shell with aliases 


I/O Redirection, & batch files. 
MICRO C Tools $24.95 


Unix style software tools for 
text editing and debugging. 


MICRO Make $34.95 


Automatically builds programs. 
Creates batch files or executes 
compiler/linker etc. directly. 


Beckemeyer Developent Tools 
592 Jean St. #304 


Oakland CA 94610 
(415)658-5318 
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ST Printer Cable @ 

Si RS232 Modem Cable 
Surge Bar with 6 outlets 
ST Disc Drive Cable 6 foot @ 


1200/300 Auto Modem (Hyes Type). only $179.95 
Citizen Printer model 120D super buy $199.95 
1040 ST Color System ond free software $1149.95 


Free shipping with any order 
We service what we sell since 1963 


COMPUTER OUTLET 
(619) 282-6200 
5861 Mission Gorge Rd. / San Diego. CA 92120 
15 DAY TRIAL/ MONEY BACK WARRANTY 
Call or write for our monthly Hot Sheet 
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The Exciting Atari ST 


Computers Are Here... 


New software and enhancements are arriving 


daily for this wonderful computer. We will 


evaluate and carry only the best products, so 
you can depend on us to support everything 


we sell! 


Call or circle our Reader Service Number on 
the Response Card to put your name on our 
mailing list. That will entitle you to our FREE 


CATALOGS with product reviews, tips and 


rumors on the ST. 


VISA and MasterCard gladly accepted 
Toll Free 800-782-7007 (Oregon 479-9516) 


OFTWAREs 


837 NE 6th St.-Grants Pass, OR 97526 
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footers, block editing, and search and replace functions. 

Probably its strongest feature is the ability to merge a pic- 
ture into the body of a document. GEM Paint files can be 
brought into the program and placed where you like. Then 
the entire document can be saved, or printed as one entity. 
This is how it works on the PC. The availability of GEM Paint 
for the ST is as questionable as is that of GEM Write itself. 

If you need the ability to merge text with graphics, then 
you may be inclined to wait around for the ST GEM Write. 
Otherwise, existing GEM-based word processors, such as 
HabaWriter and 1st Word easily outdistance GEM Write’s 
simple-minded features. 

Which is for you? 

This comparison review was based on many, many hours 
of intimate, personal, first-hand use (and, in some instances, 
abuse) with the currently available word processors for the 
Atari ST. Having had the chance to get familiar with the ST 
over the last nine months, and having used the various word 
processing programs over the last several, has allowed me try 
each program and form opinions based on empirical data. 

I began this project with no favorite programs or axes to 
grind. I’ve used dozens of word processing programs on var- 
ious computers over the last few years. In addition, I spend 
my daily working hours evaluating hardware and software 
from the user’s viewpoint. 

I feel strongly that, for an application program to be the 
best it can be, it must be designed with a particular computer 
in mind from the start. A word processing program is limit- 
ed by the hardware it runs on. If it doesn’t take advantage 
of all the hardware has to offer, it’s not an optimum program. 


WORD FOR WORD” SF 


A crossword game for the ATARI ST! 


You can play WORD FOR WORD on a game 
board that looks like this, or you can create your 
own! Drop-down menus make it easy to design 

the shape, size, and layout of the 
game board. Other features let 
you assign letter values, select a 
skill level, and challenge words. 
When the game board is the 
way you want it, invite up to three 
friends to play. And you can 
include Alphie (your computer) in the game. He 
has a 20,000 word vocabulary that is sure to chal- 
lenge and improve your skills. The choice is 
yours and the options are almost endless! 


To Order . 
Contact your Atari ST dealer, or Bay View Software 


Pe aad peice 'eag.4s) 127 Webster St., Suite A-295 

shipping and handling. : ; 

California residents add $2.40 Monterey, Calif. 93940 
sales tax. ($45.85) (408) 373-4011 
MasterCard or Visa accepted 

Works with color (medium resolution) or monochrome monitor. 

WORD FOR WORD is a trademark of Bay View Software. 
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With regard to word processing on the Atari ST, only a GEM- 
based program can offer the user the most. 

My choice, of the programs compared in this article, is 1st 
Word. With the exception of a few flaws (which, unless re- 
solved, limit its usefulness), 1st Word provides the ease of 
use, power and flexibility that an ST word processing pro- 
gram should. 

If you were lucky enough to receive 1st Word during the 
1985 Christmas season for free, all the better. But, even at 
its list price of $40, it represents what I think is the best ST 
word processor. 

1st Word should satisfy the word processing needs of the 
majority of ST owners. For that matter, HabaWriter would 
probably be okay, too (especially version 1.2). However, it’s 
slightly more expensive and is copy protected. 

If you simply must have a text-based word processor, then 
you can't beat the price of ST-Writer. It’s freely available on 
many bulletin boards and on several information services. 

Regent Word works as advertised, seems bug-free and is 
straightforward to use. Multiple menus, which can be ac- 
cessed in an instant, take you through the assorted com- 
mands. There’s no need to be a cartographer to navigate your 
way around this program. 

Final Word, from Mark of the Unicorn, is the most, of all 
of these programs. It is the most expensive, the most sophisti- 
cated, the most time-consuming to learn. It also weighs the 
most. 

Kidding aside, if you need this much power and are will- 
ing to spend some time learning the intricacies of it, Final 
Word may be just right for you. 

That’s my opinion, based upon hours of use. Of course, the 
final decision rests with you, since you'll be the one who ei- 
ther blesses or curses the day you brought a particular word 
processor home to your ST. #1 
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Computer Systems Inc. 

Quauity Sortware [ SwHeriorve) Supra Dears 
> TDI — Modulall only 649.00 > Supra 1 Meg — ST Special 
> Regent — Spell, Word Il > Supra BBS — ST Special 
> Softworks — Personal Basic 1 Meg Upgrade ST Station Packages 
> Spinnaker — Educational only 125.00 > ST Station 99.95 
& Softlogic — Clock Card > SI Station w/computer and drives 
m SI-Copy 520 ST Call (as pictured below) 

Dealer Inquiries Welcome 1040 ST Call CALL 





-9nn.f47. Quality Systems & Software -ONE.IA. 
L 800-647: 7740 at one convenient price L 206-6 24-9292 


PIONEER BUILDING ¢ 600 FIRST AVENUE SEATTLE, WA 98104 
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It takes 2 of 
their’s ( Atari) a 
to make 1 
of ours. 


THE SHANNER SD-2000 
Available Now! 


FOR LESS! 
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Why buy 2 Atari 1 Mb. Drives, separately 
packed, encased in large plastic housings 
for $599.90, when you can purchase the 
SD-2000 Drive System for $399.95. The 
SHANNER SD-2000 is comprised of two 
3.5”, 1 Mb. double sided, double density 
drives packaged in an attractive, coordi- 
nating grey METAL housing and is fully 
compatible with the Atari ST.* 


You can pay Atari or 
you can SAVE $200.00. 


You be the judge. 


$3999 


“Atari and Atari ST are trademarks of Atari Corporation. 





GUMBALL EXPRESS ORDER FORM .- For FAST delivery use this order form or call TOLL FREE 800/423-9442 


Product Description Price P&L TOTAL 
Shanner SD-2000 $399.95 $7.50 $407.45 


If you currently own either an Atari SF354 or SF314, you can use your 
existing power supply. If not, please order Model No. SD-2000PS for 
$14.95. 


O) Check here and add $14.95 to $399.95 
All products will be shipped prepaid UPS ground. 


CL) Check enclosed. (NOTE— order will be shipped when check clears). 


Make check payable to: 
Gumball Express 
707 S.W. Washington Street Suite 200 
Portland, Oregon 97205 


O VISA OJ MASTERCARD 
Name on card 


CL) INTERBANK (MasterCard only) 


Account # 

Expiration Date 

Signature 

SHIP TO: 

Name 

Address 

_ a. |. 


C.O.D.’s and purchase orders will not be accepted by Gumball Express. 
Outside the USA add $10. and make payment by bank draft, payable in 
U.S. dollars drawn on a U.S. bank. 





